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INTRODUCTION 



HP-UX is Hewlett-Packard Company's implementation of a standard operating system that is 
compatible with the AT&T UNIX* System V Release 2 operating system, but which also includes 
important features from Berkeley Software Distribution 4.2 as well as many bug fixes, enhanced 
capabilities, and other features developed by HP. This combination makes HP-UX a very powerful 
and useful operating system capable of supporting a wide range of applications ranging from sim- 
ple text processing to sophisticated engineering graphics and design. It can also be readily used to 
control instruments and other peripheral devices through the HP-IB (IEEE-488) and HP-HIL inter- 
faces as well as through GPIO interfacing. Real-time capabilities further expand HP-UX's flexibil- 
ity as a powerful tool for solving a myriad of problems in design, manufacturing, business, and 
other areas of interest. Extensive internationalization makes HP-UX readily adaptable to a myriad 
of spoken languages, and interfacing to Local Area Network and many other networking and 
resource-sharing facilities provides flexible interaction with other computers and operating sys- 
tems. Optionfd software products extend HP-UX capabilities into a broad range of specialized 
needs. 

This manual is not intended for use as a learning tool for beginners. It is a reference guide that is 
most useful to experienced users of UNIX or UNIX-like systems. If you are not already familiar 
with UNIX and HP-UX, refer to the tutorial manuals and other learning documents supplied with 
your system. System implementation and maintenance details are explained in the HP-UX System 
Administrator Manual. 



Manual Organization 

This manual is divided into several sections contained in two volumes. Volume 1 contains Sec- 
tions 1 and 9 as well as a permuted index. The remaining sections (IM and 2 thorugh 8) are in 
volume 2. 

Section 1 {Commands and Application Programs) describes programs that are usually 

invoked directly by users or from command language procedures, as opposed to 
system calls (section 2) or subroutines (section 3) that are called by user and 
application programs. Commands usually reside in the directory /bin (for 
binary programs). Some programs reside in /usr/bin to save space in /bin 
and to reduce search time for commonly-used commands. These directories are 
normally searched automatically by the command interpreter called a shell 
(s/i(l) or csh{l)). Other Section 1 commands are located in /lib and /usr/lib. 
Refer to hier(5) and tutorial manuals supplied with your system for more infor- 
mation about file system structure. 

Section IM {System Maintenance Procedures) describes commands used for system mainte- 
nance including boot processes, crash recovery, system integrity testing, and 
other needs. This section contains topics that pertain primarily to system 
administrator and super-user tasks. 

Section 2 {System Calls) describes entries into the HP-UX kernel, including the C-language 

interface. 

Section 3 {Subroutines) describes available subroutines that reside (in binary form) in vari- 

ous system libraries stored in directories /lib and /usr/lib. Refer to intro{3) 
for descriptions of these libraries and the files where they are stored. 

* UNIX is a registered trademark of AT&T Bell Laboratories, Inc. 
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Section 4 [File Formats) documents the structure of various types of files. For example, 

the link editor output-file format is described in a.out(4). Files that are used 
only by a single command (such as intermediate files used by assemblers) are not 
described. C-language struct declarations corresponding to the formats in Sec- 
tion 4 can be found in directories /usr/include and /usr/include/sys. 

Section 5 [Miscellaneous Facilities) contains a variety of information such as descriptions 

of character sets, macro packages, and other topics. 

Section 6 (Games) is absent because no games are currently supported on HP-UX. 

Section 7 [Device Special Files) discusses the characteristics of special (device) files that 

provide the link between HP-UX and system I/O devices. The names for each 
topic usually refer to the type of I/O device rather than to the names of indivi- 
dual special files. 

Section 9 [Glossary) is located in Volume 1 after Section 1. It defines selected terms used 

in this manual. 

Permuted Index 

An alphabetical listing based on rotation of the NAME line on the first page each 
manual page entry. The center column is in alphabetical order, and the name on 
the page heading related to the subject is in the right-hand column. 

Each section (except 9) contains a number of independent entries frequently referred to as man- 
pages or manual pages. Each manpage entry consists of one or more pages, with the entry or 
page name printed in the upper corners of each page. Manpage entries are arranged alphabeti- 
cally within each section of the reference, except for the introductory entry at the beginning of 
each section. Textual references to manpage entries are of the form pajename (NS) where N is the 
section number and S is a subsection identifier letter (Section 3 only). For example, zo_6urs<(3I) 
refers to an entry in the subroutine I/O library (Section 3 library subsection I) by the name of 
ioburst. 

Page numbering is arranged so that each entry starts on its own page 1. Some manpage entries 
describe several commands or routines on a single manpage. In such cases, the manpage is not 
duplicated for each topic, but appears only once, usually arranged under the first keyword appear- 
ing in the NAME section of the manpage. Occasionally, another name is used for the page. In 
such instances, the name describes the keywords in more general terms such as the entry for acct 
or acctsh in Section IM or string in Section 3. 
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SYSTEM STANDARDIZATION 

This reference is based on extensive system-design control documents that have been used to 
ensure softwsire compatiblity across HP-UX computer model lines. HP-UX is compatible with 
AT&T UNIX System V Interface Definition (SVID), but also includes important additional features 
from Berkeley Software Distribution 4.2 plus HP enhancements for international language sup- 
port, real-time, graphics, and instrumentation capabilities. HP-UX also contains numerous bug 
fixes and has been extensively tested in real-use environments. 

As of this printing, HP-UX has been implemented on HP 9000 Series 200, 300, 500, and 800 com- 
puters. This document is valid for first release of HP-UX on Series 800 as well as Release 5.2 on 
Series 300 and Series 500. Releases prior to 5.2 on Series 300, 5.1 and earlier on Series 500, and 
5.0/5.1 on Series 200 use the HP-UX Reference part number 09000-90008. 

The Integral PC also supports HP-UX, and the Series 200/300 AXE (Applications Execution 
Environment) supports a subset of the standard HP-UX operating system. A list of commands 
and features supported by various HP-UX systems is listed later in this introduction. 

PAGE HEADERS AND FOOTERS 

Since HP-UX is still being actively developed and expanded to meet the emerging demands of 
evolving technologies, some capabilities have not been fully integrated into all product implemen- 
tations. Also, some systems have unique needs that may not be appropriate on other series (such 
as osmark{iM) or oscp(lM) which are on Series 500 only). The headers and footers on each man- 
page are designed to clearly identify: 

• Whether or not the page has been standardized across model lines, and 

• Which series in the HP 9000 computer family support the features documented on that particu- 
lar page. 

If the page has been standardized, the date in the lower right corner is preceded by a standard 
version nmnber. In addition, the word HP-UX is printed in the center of the top (header) line. 

If a given manpage defines a feature that is not implemented on all series, a second header line 
identifies which series numbers support the feature. The second line, when present, contains 
Series xxx Only or Series xxx Implementation, where xxx represents the series numbers that 
support the page. The word "implementation" in the header indicates that the feature is imple- 
mented on each series indicated but that the implementation on one series differs from another in 
various aspects of its operation. Such cases typically arise when hardware distinctions force 
software imiqueness (such as in assemblers). 

If a manpage is missing the version number at the bottom and the HP-UX label at the top, the 
feature has not been standardized, and should not be used in software that must be readily port- 
able without modification across various HP-UX systems. 
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MANPAGE FORMATS 

All manpage entries follow an established topic format, but not all topics are included in each 
entry. 

NAME Gives the name(s) of the entry and briefly states its purpose. 

SYNOPSIS Summarizes the use of the entry or program entity being described. A few con- 
ventions are used: 

Boldface strings are literals, and are to be typed exactly as they appear in the 
manual. 

Italic strings represent substitutable argument names and program names found 
elsewhere in the manual. 

Square brackets [] aroimd an argument name indicate that the argument is 
optional. 

Ellipses (...) are used to show that the previous argument can be repeated. 

A final convention is used by the commands themselves. An argument beginning 
with a dash (-), a plus sign (+), or an equal sign (=) is often taken to be some 
sort of flag argument, even if it appears in a position where a file name could 
appear. Therefore it is unwise to have files names that begin with , +, or =. 

DESCRIPTION 

Discusses the function and behavior of each entry. 

HARDWARE DEPENDENCIES 

Points out variations in HP-UX operation that are related to the use of specific 
hardware or combinations of hardware. 

EXAMPLES Provides examples of typical usage, where appropriate. 

FILES Lists file names that arc built into the program or command. 

RETURN VALUE 

Discusses various values returned upon completion of program calls. 

SEE ALSO Provides pointers to related topics. 

DIAGNOSTICS 

Discusses diagnostic indications that may be produced. Self-explanatory mes- 
sages are not listed. 

WARNINGS Points out potential pitfalls. 

BUGS Discusses known bugs and observed deficiencies. Occasionally, suggested fixes 

are provided. 

AUTHOR Indicates the origin of the software documented by the manpage. 

Some manual pages also include examples for illustration purposes to indicate typical use. 

The table of contents included at the beginning of each volume contains a complete listing of all 
manpages in the order they appear in each section. Additional alphabetical entries identify all 
keywords on manpages that document multiple keywords, providing an easy path for locating 
commands and features whose names do not match the title heading on the corresponding man- 
page. 
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HOW TO GET STARTED 

This discussion provides a very brief overview of how to use HP-UX: how to log in and log out, 
how to communicate through your machine, and how to run a program (if you are a beginning 
user, refer to other tutorial manuals for a more complete introduction to the system.) 

Logging In 

To log in you must have a valid user name, which may be obtained from your system administra- 
tor. Keep pressing the "break" or "del" until the login: message appears. 

When a connection has been established, the system displays login: on your terminal. Type your 
user name then press the RETURN key. If you have a password (and you should!), the system asks 
for it, but does not print it on the terminal. 

It is important that you type in your login name in lowercase if possible. If you type uppercase 
letters, HP-UX assumes that your terminal cannot generate lowercase letters, and treats subse- 
quent uppercase input as lowercase. When you have logged in successfully, the shell displays a $ 
prompt unless programmed for a different prompt (the shell is described below under How to run 
a program). 

For more information, consult login{l) and getty{8), which discuss the login sequence in more 
detail, £md stty{l), which tells you how to describe the characteristics of your terminal to the sys- 
tem {profile{5) explains how to accomplish this last task automaticsdly every time you log in). 

Logging Out 

You can log out by typing an end-of-file indication (ASCII EOT character, usually typed as 
"control-d") to the shell (see csh(l) for information about ignoreeof if you are using C-shell). The 
shell will terminate and the login: message will appear again. 

How to Communicate Through Your Terminal 

HP-UX gathers keyboard input characters and saves them in a buffer. The accumulated charac- 
ters are not passed to the shell or other program until a RETURN is typed. 

HP-UX terminal input/output is full-duplex. It has full read-ahead, which means that you can 
type at any time, even while a program is printing on your display or terminal. Of course, if you 
type during output, the output will have the input characters intepspersed in it. However, what- 
ever you type will be saved and interpreted in the correct sequence. There is a limit to the 
amoimt of read-ahead, but it is generous and not likely to be exceeded unless the system is 
severely overloaded or operating abnormally. When the read-ahead limit is exceeded, the system 
throws away all the saved characters. 



Erase, Kill, and Output Interrupt/Resume Characters 

On an input line from the terminal, the character @ "kills" all characters typed before it. The 
character # erases the last character typed. Successive uses of # will erase characters back to, but 
not beyond, the beginning of the line; @ and # can be typed as themselves by preceding them 
with \ (thus to erase a \, you need two #s). These default erase cind kill characters can be 
changed, and usually are (see stty{l)). 
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The ASCII DCS (control-s) character can be used to temporarily stop output. It is useful with 
CRT terminals to prevent output from disappearing before it can be read. Output is resumed 
when any character is typed. If DCl (control-q) or DCS are used to restart the program, they 
are not saved and passed to later programs. Any other characters are saved and passes as output 
to later programs. 



Interrupt and Quit Characters 

The ASCII DEL character (sometimes labelled "rubout" or "rub") is not passed to programs, but 
instead generates an interrupt signal , just like the "break", "interrupt", or "attention" signal. 
This signal generally causes whatever program you are running to terminate. It is typically used 
to stop a long printout that you don't want. However, programs can arrange either to ignore this 
signal altogether, or to be notified when it happens (instead of being terminated). The editor 
e(i(l), for example, catches interrupts and stops what it is doing, instead of terminating, so that 
an interrupt can be used to halt an editor printout without losing the file being edited. 

The quit signal is generated by typing the ASCII octal 34 (control-\) character. It causes a running 
program to terminate. 



End-of-Line and Tab Characters 

Besides adapting to the speed of the terminal, HP-UX tries to be intelligent as to whether you 
have a terminal with a new-line (line-feed) key, or whether it must be simulated with a carriage- 
return and line-feed pair. In the latter case, all incoming carriage-return characters are changed to 
line-feed characters (the standard line delimiter), and a carriage-return/line- feed pair is echoed to 
the terminal. If you get into the wrong mode, see stty(l). 

Tab characters are used freely in HP-UX source programs. If your terminal does not have the tab 
function, you can arrange to have tab characters changed into spaces during output, and echoed 
as spaces during input (not currently supported on Series 500). The stty{l) command will set or 
reset this mode. The system assumes that tabs are set every eight character positions. The tabs{l) 
command will set tab stops on your terminal, if that is possible. 

How to Run a Program 

When you have successfully logged into HP-UX, a program called a shell is monitoring input from 
your terminal. The shell accepts typed lines from the terminal, splits them into command names 
and arguments, then executes the command which is nothing more than an executable program. 
Usually, the shell looks first in your current directory (discussed below) for a program with the 
given name, and if none is there, then in system directories. There is nothing special about 
system-provided commands except that they are kept in directories where the shell can find them. 
You can also keep commands in your own directories and arrange for the shell to find them there. 

The command name is the first word on an input line to the shell; the command and its argu- 
ments are separated from one another by space and/or tab characters. 

When a program terminates, the shell will ordinarily regain control and type a $ at you to indi- 
cate that it is ready for another command. The shell has many other capabilities, which are 
described in detail in sh(l). 
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The Current Directory 

HP-UX has a file system arranged in a hierarchy of directories. When the system administrator 
gave you a user name, he or she also created a directory for you (ordinarily with the same name 
as your user name, and known as your login or home directory). When you log in, that directory 
becomes your current or working directory, and any file name you type is assumed to be in that 
directory by default. Because you are the owner of this directory, you have full permissions to 
read, write, alter, or destroy its contents. The permissions you have in other directories and files 
will have been granted or denied to you by their respective owners, or by the system administra- 
tor. To change the current working directory use cd{l). 

Path Names 

To refer to files not in the current directory, you must use a path name. Full path names begin 
with /, which is the name of the root directory of the whole file system. After the slash comes the 
name of each directory containing the next sub-directory (followed by a /), until finally the file 
name is reached (e.g., /usr/ae/filex refers to file filex in directory ae, while ae is itself a sub- 
directory of usr ; usr springs directly from the root directory). See the glossary for a formal 
definition of path name. 

If you current directory contains subdirectories, the path names of files therein begin with the 
name of the corresponding subdirectory {without a prefixed /). Without important exception, a 
path name may be used anywhere a file name is required. 

Important commands that modify the contents of files are cp(l), mv{l), and rm(I), which respec- 
tively copy, move (i.e., rename), and remove files. To find out the status of files or directories, use 
ls{l). Use mkdir{l) for making directories and rmdir(l) for destroying them. 

For a more complete discussion of the file system, see the references cited at the beginning of the 
Introduction above. It may also be useful to glance through Section 2 of this manual, which 
discusses system calls, even if you don't intend to deal with the system at that level. 

Writing a Program 

To enter the text of a source program into an HP-UX file, use erf(l), ex{l), or vi{l). The three 
principal languages available under HP-UX are C (see cc(l)), FORTRAN (see /77(1)), and Pascal 
(see pc(l)). After the program text has been entered with the editor and written into a file 
(whose name has the appropriate suffix), you can give the name of that file to the appropriate 
language processor as an argument. Normally, the output of the language processor will be left in 
a file in the current directory named a.out (if that output is precious, use mv{l) to give it a less 
vulnerable name) . If the program is written in assembly language, you will probably need to link 
library subroutines with it (see ld{l)). FORTRAN, C, and Pascal call the linker automatically. 

When you have gone through this entire process without encountering any diagnostics, the result- 
ing program can be run by giving its name to the shell in response to the $ prompt. 

Your programs can receive arguments from the command line just as system programs do by 
using the argc, argv, and envp parameters. See the supplied C tutorial for details. 
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Text Processing 

Almost all text is entered through editors ed(l), ex{l), or vi{l). The commands most often used 
to write text on a terminal are cat{l) and pr(l). The cat{l) commfind simply dumps ASCII text 
on the terminal, with no processing at all. The pr(l) command paginates the text, supplies head- 
ings, and has a facility for multi-column output. 

Inter-User Communication 

Certain commands provide inter-user communication. Even if you do not plan to use them, it 
would be well to learn something about them, because someone else may direct them toward you. 
To communicate with another user currently logged in, rvrite{l) can be used to transfer text 
directly to that user's terminal display (if permission to do so has been granted by the user). 
Otherwise, mail{l) or mailx{l) sends a message to that user's mailbox. The user is then informed 
by HP-UX that mail has arrived (if currently logged in) or mail is present (when he or she next 
logs in). Refer to the mail, mailx, and write, manpages in Section 1 for explanations of how each 
of these commands is used. 

When you log in, a message-of-the-day may greet you before the first $ prompt. 



HP-UX FILE SYSTEMS 

HP-UX supports several file systems, depending on which series you are using. The three systems 
implemented are: 

BFS Bell File System. This file system format is implemented on the Integral PC and on 
Series 200 prior to HP-UX Release 5.0. BFS files can be accessed on newer systems 
by using the BIF (Bell Interchange Format) utilities such as bifcp(l), bifls{l), 
biffind{l), etc. 

HFS High-performance File System. This file system format is implemented on all Series 
300 and 800 systems, and on Series 200 beginning at Release 5.0. 

SDF Structured Directory Format. This file system format is implemented on all Series 
500 releases. Use the SDF utilities such as sdfcp{l), sdfinit{l), sdfrm{l), sdffind{\), 
etc. to access SDF files from other systems. 

File system formats are transparent to most users, and are of little importance in most applica- 
tions. Most of the time, formats only prevent direct reading of disks of a particular format on a 
machine that supports a different format. Thus, SDF cannot be read on an HFS system without 
using SDF utilities. However, an SDF-based system can readily transfer files to an HFS-based sys- 
tem over UUCP, LAN, or other data communication facilities. 

When transportable data is needed, a tape cartridge or flexible disk can be used. Flexible disks 
can be readily formatted and read or written in LIF (Logical Interchange Format) using the lifinit, 
lifcp, lifts, lifrename, and lifrm commands in Section 1, and are easily used on other non-HP-UX 
systems that support the HP LIF format. 
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IMPLEMENTED STANDARD COMMANDS 

The following commands and facilities from the HP-UX Standard have been implemented on the 
series indicated. For commands and other features implemented on the Series 300 AXE (Applica- 
tions Execution Environment), refer to the Application Execution Environment User's Guide. 



Section 1 Commands: All Systems 



acctcom(l) 


difr3(l) 


id(l) 


nroff(l) 


tail(l) 


adjust(l) 


diffh(l) 


insertmsg(l) 


od(l) 


tar(l) 


admin(l) 


diffmk(l) 


inv(l) 


osdd(l) 


tbl(l) 


ar(l) 


dircmp(l) 


ipcrm(l) 


pack(l) 


tee(l) 


as(l) 


dimaine(l) 


ipcs(l) 


page(l) 


test(l) 


asa(l) 


disable(l) 


join(l) 


passwd(l) 


time(l) 


at(l) 


du(l) 


kill(l) 


paste(l) 


touch(l) 


awk(l) 


dumpmsg(l) 


1(1) 


pathalias(l) 


tput(l) 


banner(l) 


echo(l) 


last(l) 


pc(l) 


tr(l) 


basename(l) 


ed(l) 


lastb(l) 


pcat(l) 


true(l) 


batch(l) 


edit(l) 


ld(l) 


pdpll(l) 


tset(l) 


bc(l) 


egrep(l) 


leave(l) 


Pg(l) 


tsort(l) 


bdifr(i) 


enable(l) 


lex(l) 


pr(l) 


tty(l) 


bfs(l) 


env(l) 


lifcp(l) 


prealloc(l) 


u3b(l) 


bs(l) 


ex(l) 


lifinit(l) 


primes(l) 


u3b5(l) 


cal(l) 


expand(l) 


lifls(l) 


prmail(l) 


ul(l) 


calendar(l) 


expr(l) 


lifrename(l) 


prs(l) 


umask(l) 


cancel(l) 


f77(l) 


lifrm(l) 


ps(l) 


uname(l) 


cat(l) 


factor(l) 


line(l) 


ptx(l) 


unexpand(l) 


cb(l) 


false(l) 


lint(l) 


pwd(l) 


unget(l) 


cc(l) 


fc(l) 


11(1) 


ratfor(l) 


uniq(l) 


cd(l) 


fgrep(l) 


ln(l) 


red(l) 


units(l) 


cdc(l) 


file(l) 


lock(l) 


rev(l) 


unpack(l) 


cflow(l) 


find(l) 


login(l) 


rm(l) 


uucp(l) 


chgrp(l) 


findmsg(l) 


logname(l) 


rmail(l) 


uulog(l) 


chmod(l) 


findstr(l) 


lorder(l) 


nndel(l) 


uuname(l) 


chown(l) 


fixman(l) 


lp(l) 


rmdir (1) 


uupick(l) 


chsh(l) 


fold(l) 


Ipstat(l) 


rmnl(l) 


uustat(l) 


clear(l) 


from(l) 


ls(l) 


rsh(l) 


uuto(l) 


cmp(l) 


gencat(l) 


Isf(l) 


rtprio(l) 


uux(l) 


col(l) 


get(l) 


Isr(l) 


sact(l) 


val(l) 


comb(l) 


getopt(l) 


Isx(l) 


sccsdiff(l) 


vax(l) 


comm(l) 


grep(l) 


m4(l) 


sdb(l) 


vc(l) 


cp{l) 


hashcheck(l) 


mail(l) 


sdifr(l) 


vi(l) 


cpio(l) 


hashmake(l) 


mailx(l) 


sed(l) 


vis(l) 


cpp(l) 


head(l) 


make(l) 


sh(l) 


wait(l) 


crontab(l) 


help(l) 


makekey(l) 


size(l) 


wc(l) 


csh(l) 


hostname(l) 


man(l) 


sleep(l) 


what(l) 


ctags(l) 


hp(l) 


mesg(l) 


sort(l) 


whereis(l) 


cu(l) 


hp9000s200(l) 


mkdir(l) 


spell(l) 


which(l) 


cut(l) 


hp9000s300(l) 


mkstr(l) 


spellin(l) 


who(l) 


cxref(l) 


hp9000s500(l) 


mm(l) 


split(l) 


whoami(l) 


date(l) 


hp9000s800(l) 


more(l) 


ssp(l) 


write(l) 


dc(l) 


hyphen(l) 


mt(l) 


strings(l) 


xargs(l) 


dd(l) 

ard Company 


id(l) 


mv(l) 
-9- 


stty(l) 


xd(l) 
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delta(l) 


insertmsg(l) 


neqn(l) 


su(l) 


deroff(l) 


inv(l) 


newfonn(l) 


sum(l) 


diff(l) 


ipcnn(l) 


newgrp(l) 


tabs(l) 



Distribution of crypt (I) which runs on all series is restricted. 



yacc(l) 



Section 1 Commands: Series 200, 300, and 500 Only 

bifchgrp(l) bifcp(l) bifmkdir(l) cdb(l) 

bifchmod(l) biffind(l) bifrm(l) ct(l) 

bifchown{l) bifls(l) bifnndir(l) fdb(l) 



pdb(l) 
send(l) 



Section 1 Commands: Series 200, 300, and 800 Only 



adb(l) 


groups(l) 


prof(l) 


slp(l) 


tcio(l) 


getprivgrp(l) 


mediainit(l) 










Section 1 Commands: Series 300 and 800 Only 




sdfchmod(l) 


sdfcp(l) 


sdfln(l) 


sdfmv(l) 


iostat(l) 


sdfchgrp(l) 


sdffind(l) 


sdfls(l) 


sdfrm(l) 




sdfchown(l) 


sdm(l) 


sdfmkdir(l) 


sdfrmdir(l) 






Section 1 Commands: Series 800 


Only 




csplit(l) 


nm(l) 


strip(l) 


vmstat(l) 




_exit(2) 


fchinod(2) 


ioctl(2) 


rtprio(2) 


sigspace(2) 




Section 2 System Calls: All Systems 




access(2) 


fchown(2) 


kill{2) 


sbrk(2) 


sigvector(2) 


acct(2) 


fcntl(2) 


link(2) 


select (2) 


Stat (2) 


alarm(2) 


fork(2) 


lockf(2) 


semctl(2) 


stime(2) 


brk(2) 


fstat(2) 


lseek(2) 


semget(2) 


stty(2) 


chdir(2) 


fsync(2) 


mkdir(2) 


semop(2) 


sync(2) 


chmod(2) 


ftruncate(2) 


mknod(2) 


setgid{2) 


time(2) 


chown(2) 


getegid(2) 


mount(2) 


sethostname(2) 


times(2) 


chroot(2) 


geteuid(2) 


msgctl(2) 


setitimer(2) 


truncate(2) 


close(2) 


getgid(2) 


msgget(2) 


setpgrp(2) 


ulimit{2) 


creat(2) 


gethostname(2) 


msgop(2) 


setpgrp2(2) 


umask(2) 


dup(2) 


getitiiner(2) 


nice(2) 


settimeofday(2) 


umount(2) 


dup2(2) 


getpgrp(2) 


open(2) 


setuid(2) 


unanie(2) 


errno(2) 


getpgrp2(2) 


pause(2) 


shmctl(2) 


unlink(2) 


execl(2) 


getpid(2) 


pipe(2) 


shmget(2) 


ustat(2) 


execle(2) 


getppid(2) 


plock(2) 


shmop(2) 


utiine(2) 


execlp(2) 


gettimeofday(2) 


prealloc(2) 


sigblock(2) 


vfork(2) 


execv(2) 


getuid(2) 


read(2) 


signal(2) 


wait(2) 


execve(2) 


gtty(2) 


readv(2) 


sigpause(2) 


write(2) 


execvp(2) 


intro(2) 


rmdir(2) 


sigsetmask(2) 


writev(2) 


exit(2) 
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Section 2 System Calls: Series 200, 300, and 800 Only 

ftime{2) getprivgrp(2) ptrace(2) setgroups(2) 

getgroups(2) profil(2) reboot(2) setprivgrp(2) 



swapon(2) 



ems(2) 

memadvise(2) 

memallc{2) 



Section 2 System Calls: Series 500 Only 

memchmd(2) mein!ck(2) memvary(2) vson(2) 

memfree(2) memulck(2) vsadv(2) vsoff(2) 



setresgid(2) 



Section 2 System Calls: Series 800 Only 

setresuid(2) 



Section 3 Subroutines: All Systems 



_tolower(3C) 


gamma(3M) 


13tol(3C) 


setkey(3C) 


_toupper(3C) 


gcvt(3C) 


164a(3C) 


setpwent(3C) 


a641(3C) 


getc(3S) 


langinfo(3C) 


setutent(3C) 


abort (3C) 


getchar(3S) 


langtoid(3C) 


setvbuf(3S) 


abs(3C) 


getcwd(3C) 


lcong48(3C) 


sgetl(3X) 


acos(3M) 


getenv(3C) 


ldexp(3C) 


signgain(3M) 


asctime(3C) 


getfsent(3X) 


lfind(3C) 


sm(3M) 


asin(3M) 


getfsfile(3X) 


localtime(3C) 


sinh(3M) 


assert (3X) 


getfsspec(3X) 


log(3M) 


sleep(3C) 


atan(3M) 


getfstype(3X) 


loglO(3M) 


sprintf(3S) 


atan2(3M) 


getgrent(3C) 


logname(3X) 


sprintinsg(3C) 


atof(3C) 


getgrgid(3C) 


longJmp(3C) 


sputl(3X) 


atoi(3C) 


getgrnam(3C) 


lrand48(3C) 


sqrt(3M) 


atol(3C) 


getlogin(3C) 


lsearch(3C) 


srand(3C) 


bsearch(3C) 


getmsg(3C) 


ltol3(3C) 


srand48(3C) 


calloc(3C) 


getopt(3C) 


mallinfo(3X) 


sscanf(3S) 


calloc(3X) 


getpass(3C) 


maJloc(3C) 


ssignal(3C) 


catread(3C) 


getpw(3C) 


malIoc(3X) 


stdio(3S) 


ceil(3M) 


getpwent(3C) 


mallopt(3X) 


strcat(3C) 


clearerr(3S) 


getpwnam(3C) 


matherr(3M) 


strchr(3C) 


clock(3C) 


getpwuid(3C) 


meniccpy(3C) 


strcmp(3C) 


closedir(3C) 


gets(3S) 


memchr(3C) 


strcmpl6(3C) 


cos(3M) 


getutent(3C) 


memcmp(3C) 


strcmp8(3C) 


cosh(3M) 


getutid(3C) 


memcpy(3C) 


strcpy(3C) 


crypt (30) 


getutline(3C) 


memset(3C) 


strcspn(3C) 


ctermid(3S) 


getw(3S) 


mktemp(3C) 


strlen(3C) 


ctime(3C) 


gmtime(3C) 


modf(3C) 


strncat(3C) 


currlangid(3C) 


gpio_get_status(3I) 


mrand48(3C) 


stmcmp(3C) 


curses(3X) 


gpio_set_ctl(3I) 


nl_asctime{3C) 


strncmpl6(3C) 


cuserid(3S) 


gsignal(3C) 


nl_atof(3C) 


stmcmp8(3C) 


daylight (3C) 


hcreate(3C) 


nl_ctime(3C) 


strncpy(3C) 


dial(3C) 


hdestroy(3C) 


nl_gcvt(3C) 


strpbrk(3C) 


drand48(3C) 


hpib_abort(3I) 


nl_isalnum(3C) 


strrchr(3C) 


ecvt(3C) 


hpib_bus_status(3I) 


nl_isalpha(3C) 


strspn(3C) 


edata(3C) 


hpib_card_ppoll_resp(3I) 


nLisgraph(3C) 


strtod(3C) 


ard Company 
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encrypt(3C) 


hpib_eoL_ctl(3I) 


nl_islower(3C) 


strtok(3C) 


end(3C) 


hpib_io(3I) 


nl_isprint(3C) 


strtol(3C) 


endfsent(3X) 


hpib_pass_ctl(3I) 


nl_ispunct(3C) 


swab(3C) 


endgrent(3C) 


hpib_ppoll(3I) 


nl_isupper(3C) 


sys_errlist(3C) 


endpweiit(3C) 


hpib_ppoll_resp_ctl(3I) 


nl^strtod(3C) 


sys_nerr(3C) 


endutent(3C) 


hpib_ren_ctl(3I) 


nl_tolower(3C) 


system(3S) 


erand48(3C) 


hpib_rqst^srvce(3I) 


nl_tools_16{3C) 


tan(3M) 


erf(3M) 


hpib_jsend cmnd (31 ) 


nl_toupper(3C) 


tanh(3M) 


erfc(3M) 


hpib_jspoll(3I) 


nrand48(3C) 


tdelete{3C) 


errno(3C) 


hpib__status_wait(3I) 


opendir(3C) 


telldir(3C) 


etext(3C) 


hpib_wait_on — ppoll(3I) 


optarg(3C) 


terapnam(3S) 


exp{3M) 


hsearch(3C) 


opteiT(3C) 


tfind(3C) 


fabs(3M) 


hypot(3M) 


optind(3C) 


tgetent(3X) 


fclose(3S) 


idtolang(3C) 


pclose(3S) 


tgetflag(3X) 


fcvt(3C) 


initgroups(3C) 


perror(3C) 


tgetnum(3X) 


fdopen(3S) 


io_eol_ctl(3I) 


popen(3S) 


tgetstr(3X) 


feof(3S) 


io_get_t erm reason ( 31 ) 


pow(3M) 


tgoto{3X) 


ferror(3S) 


io_interrupt_ctl(3I) 


printf(3S) 


timezone(3C) 


fflush(3S) 


io_lock(3I) 


printmsg(3C) 


tmpfile(3S) 


fgetc(3S) 


io_on interrupt(3I) 


putc(3S) 


tmpnam(3S) 


fgetgrent(3C) 


io_reset(3I) 


putchar(3S) 


toascii(3C) 


fgetpwent(3C) 


io_speed_ctl(3I) 


putenv(3C) 


tolower(3C) 


fgets(3S) 


io_timeout_ctl(3I) 


putpwent(3C) 


toupper(3C) 


fileno(3S) 


io_unlock(3I) 


puts(3S) 


tputs(3X) 


floor(3M) 


io_width_ctl(3I) 


pututline(3C) 


tsearch(3C) 


fmod(3M) 


isalnum(3C) 


putw(3S) 


ttyname(3C) 


fopen(3S) 


isalpha(3C) 


qsort(3C) 


ttyslot(3C) 


fprintf(3S) 


isascii(3C) 


rand(3C) 


twalk(3C) 


fprmtmsg(3C) 


isatty(3C) 


readdir(3C) 


tzname(3C) 


fputc(3S) 


iscntrl(3C) 


realloc(3C) 


tzset(3C) 


fputs(3S) 


isdigit(3C) 


realloc(3X) 


undial(3C) 


fread(3S) 


isgraph(3C) 


regcmp(3X) 


ungetc(3S) 


free(3C) 


islower(3C) 


regex(3X) 


utmpname(3C) 


free(3X) 


isprmt(3C) 


rewind(3S) 


vfprintf(3S) 


freopen(3S) 


ispTmot(3C) 


rewinddir(3C) 


vprintf(3S) 


frexp(3C) 


isspace(3C) 


scanf(3S) 


vsprintf(3S) 


fscanf(3S) 


isupper(3C) 


seed48(3C) 


yO{3M) 


fseek(3S) 


isxdigit(3C) 


seekdir(3C) 


yl(3M) 


ftell(3S) 


jO{3M) 


setbuf(3S) 


yn(3M) 


ftok(3C) 


jl(3M) 


setfsent(3X) 




ftw(3C) 


jn(3M) 


setgrent(3C) 




fwrite(3S) 


jrand48(3C) 


setjmp(3C) 





Distribution of crypt{3C) and encrypt{3C) which run on all series is restricted. 

Section 3 Subroutines: Series 200/300 and 800 Only 

monitor(3C) nlist(3C) 



blmode(3C) 



Section 3 Subroutines: Series 800 Only 

datalock(3C) 
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bif(4) 



Section 4 Files: All Systems 



a.out(4) 


cpio(4) 


inittab(4) 


modeI(4) 


ttytype(4) 


acct(4) 


dialups(4) 


issue(4) 


passwd(4) 


tztab{4) 


ar(4) 


d passwd(4) 


lif(4) 


profile(4) 


utmp(4) 


checklist (4) 


fspec(4) 


magic (4) 


sccsfile(4) 


wtmp(4) 


col_^eq_8(4) 


gettydefs(4) 


mknod(4) 


term(4) 


btmp(4) 


core (4) 


group(4) 


mnttab(4) 


terminfo(4) 





Section 4 Files: Series 200, 300, and 500 Only 



dir(4) 
disktab(4) 



Section 4 Files: Series 200, 300, and 800 Only 

fs(4) inode(4) nlist(4) 



privgrp(4) 



sdf(4) 



Section 4 Files: Series 300 and 800 Only 



advance{5) 

ascii(5) 

compile(5) 

environ(5) 

ERROR(5) 

fcntl(5) 



Section 5 Miscellaneous: All Systems 

GETC(5) kana8(5) PEEKC(5) term(5) 

hier(5) langid(5) RETURN(5) types(5) 

hpnls(5) man(5) roman8(5) UNGETC(5) 

INIT(5) math(5) stat(5) values(5) 

ioctl(5) mm(5) step(5) varargs(5) 



prof(5) 



Section 5 Miscellaneous: Series 800 Only 



console(7) 

ct(7) 
disk(7) 



Section 7 Device Files: All Systems 

lp(7) mt(7) pty(7) 



modem(7) 



null(7) 



stty(7) 



termio(7) 
tty(7) 



Section 7 Device Files: Series 200/300 and 800 Only 

mem(7) kmem(7) 
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IMPLEMENTED NON-STANDARD AND 
HARDWARE-DEPENDENT COMMANDS 

The following non-standard commands and facilities and hardware-dependent features have 
been implemented on the series indicated: 



Series 300 Only 

as(l) 

astm(l) 

atrans(l) 



dos2ux(l) 

doschmod(l) 

doscp(l) 



dosdf(l) 
dosls(l) 
dosnikdir(l) 



mvdevs(lM) (temporary command, Release 5.2 only) 
crt0(3): crtO.o, mcrtO.o, frtO.o, mfrtO.o cvtnum(3C) 
dosif(4) 



dosrm(l) 
pam(l) 

reconfig(lM) 



Series 200/300 Only 

chatr(l) Isdev(l) 

backup(lM) config(lM) 

io_burst(3I) 



nm{l) 



a.out(4) 


core(4) 


master(4) 






graphics(7): CRT graphics 


iomap(7) 






Series 500 Only 










aterm(l) 

backup(l) 

chatr(l) 


err(l) 
ftio(l) 
linkinfo(l) 


Isdev(l) 
nm(l) 


query(l) 
revision(l) 


tcio(l) 
upm(l) 


autobkup(lM) 
backup(lM) 

chsys(lM) 


osck(lM) 
oscp(lM) 


osmark(lM) 
osmgr(lM) 


rootmark(lM) 
stopsys(lM) 


uconfig(lM) 
vstat(lM) 


errinfo(2) 


trapno(2) 








intrapofr(3M) 


intrapon(3M) 








a.out(4) 
core(4) 


dir(4) 


errfile(4) 


fs(4) 


inode(4) 



Series 300/500 Only 

compress(l) uncompress(l) zcat(l' 

man(l) (compressed manucd pages version) 
shl(l) stty(l) tty(l) 

catman(lM) (compressed manual pages version) 
Series 200, 300, and 500 Only 



mkrs(lM) 



arcv(l) 
basic(l) 


ccat(l) 
compact(l) 


kermit(l) 
strip(l) 


mnodem(l) 
uncompact(l) 


revck(lM) 


sysrm(lM) 


update(lM) 


vtdaemon(lM) 


ranlib(4) 









vt(l) 
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Series 800 Only 










as(l) 


Issf(l) 


xdb(l) 


hpux(lM) 


devices(4) 


hpiutil(l) 


mksf(l) 


boot(lM) 


isl(lM) 


afi(7) 


insf(l) 


psqlc(l) 


decode(lM) 


pdc(lM) 


diagO(7) 


iquery(l) 


sqlutil(l) 


delog(lM) 


sysdiag(lM) 


hpib(7) 


isql(l) 


uxgen(l) 


disksecn(lM) 


a.out(4) 




Series 800 HPIMAGE(3X) Non-Standard Commands 






hpibegin(3X) 


hpifindset(3X) 


hpiimdo(3X) 


chpierror(3X) 


chpiopen(3X) 


hpiclose(3X) 


hpiget(3X) 


hpiupdate(3X) 


chpifind(3X) 


chpiput(3X) 


hpicontrol(3X) 


hpiinfo(3X) 


chpibegin(3X) 


chpifindset(3X) 


chpiundo(3X) 


hpideiete(3X) 


hpilock(3X) 


chpiclose(3X) 


chpiget(3X) 


chpiupdate(3X) 


hpiend(3X) 


hpimemo(3X) 


chpicontrol(3X) 


chpiinfo(3X) 




hpierror(3X) 


hpiopen(3X) 


chpidelete(3X) 


chpilock(3X) 




hpifind(3X) 


hpiput(3X) 


chpiend(3X) 


chpimemo(3X) 
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TABLE OF CONTENTS 
VOLUME 1 



1. Commands 



intro introduction to command utilities and application programs 

acctcom search and print process accounting file(s) 

adb debugger 

adjust simple text formatter 

admin create and administer SCCS files 

ar archive and library maintainer for portable archives 

arcv convert archives to new format 

as assembler 

as (Series 300 only) assembler for MC68000, MC68010, and MC68020 

as (Series 800 only) assembler (Precision Architecture) 

aslO, as20 (see as(l) Series 300 version) 

asa interpret ASA carriage control characters 

astm (Series 200/300 only) translate assembly language 

at, batch execute commands at a later time 

aterm (Series 500 only) general purpose asynchronous terminal emulation 

atrans (Series 200/300 only) translate assembly language 

awk text pattern scanning and processing language 

banner make posters in large letters 

basename, dimame extract portions of path names 

basic (Series 200/300, 500 only) Technical BASIC interpreter 

batch (see at(l)) 

be arbitrary-precision arithmetic language 

bdiff bigdiff 

bfs big file scanner 

bifchgrp (see bifchown(l)) 

bifchmod change mode of a BIF file 

bifchown, bifchgrp change file owner or group 

bifcp copy to or from BIF files 

biffind find files in a BIF system 

bifls list contents of BIF directories 

bifmkdir make a BIF directory 

bifrm, bifrmdir remove BIF files or directories 

bifrmdir (see bifrm(l)) 

bs a compiler/interpreter for modest-sized programs 

cal print calendar 

calendar reminder service 

cancel (see lp(l)) 

cat concatenate, copy, and print files 

cb C program beautifier, formatter 

cc C compiler 

cd change working directory 

cdb, fdb, pdb C, FORTRAN, Pascal symbolic debugger 

cdc change the delta commentary of an SCCS delta 

cflow generate C flow graph 

chatr (Series 200/300 only) change program's internal attributes 

chatr (Series 500 only) change program's internal attributes 

chgrp (see chown(l)) 

chmod change mode 

chown, chgrp change file owner or group 

chsh change default login shell 

clear clear terminal screen 

cmp compare two files 
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col filter reverse line-feeds and backspaces 

comb combine SCCS deltas 

conun select or reject lines common to two sorted files 

compact, uncompact, ccat (Series 200/300, 500 only) compress and uncompress files, and cat them 

compress, imcompress, zcat (Series 300 and 500 only) compress and expand data 

cp, In, mv copy, link or move files 

cpio copy file archives in and out 

cpp the C language preprocessor 

crontab user crontab file 

crypt encode/decode files 

csh a shell (command interpreter) with C-like syntax 

csplit context split 

ct spawn getty to a remote terminsil (call terminal) 

ctags create a tags file 

cu call another (UNIX) system; terminal emulator 

cut cut out selected fields of each line of a file 

cxref generate C program cross-reference 

date print and set the date 

dc desk calculator 

dd convert, reblock, translate, find copy a (tape) file 

delta make a delta (change) to an SCCS file 

deroff remove nroff/troff, tbl, and eqn constructs 

diff, diffh differential file comparator 

diff3 3-way differential file comparison 

diffh (seediff(l)) 

diffmk mark differences between files 

dircmp directory comparison 

dimame (see basename(l)) 

disable (see enable(l)) 

dos2ux (Series 300 only) convert ASCII file format 

doschmod (Series 300 only) change attributes of a DOS file 

doscp (Series 300 only) copy to or from DOS files 

dosdf (Series 300 only) report nmnber of free disk clusters 

dosls, dosU (Series 300 only) list contents of DOS directories 

dosmkdir (Series 300 only) make a DOS directory 

dosrm, dosrmdir (Series 300 only) remove DOS files or directories 

du summarize disk usage 

dumpmsg (see findmsg(l)) 

echo echo (print) arguments 

ed, red text editor 

edit text editor (variant of ex for casual users) 

egrep (see grep(l)) 

enable, disable enable/disable LP printers 

env set environment for command execution 

err (Series 500 only) report error information on last failure 

ex text editor 

expand, imexpand expand tabs to spaces, and vice versa 

expr evaluate argmnents as an expression 

m, fc FORTRAN 77 compiler 

factor, primes factor a number, generate large primes 

false (see true(l)) 

fc (seefr7(l)) 

fdb (seecdb(l)) 

fgrep (see grep(l)) 

file determine file type 
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find find files 

findmsg, dumpmsg create message catalog file for modification 

findstr find strings for inclusion in message catalogs 

fixman fix manual pages for faster viewing with man(l) 

fold fold long lines for finite width output device 

from who is my mail from? 

ftio faster tape I/O 

gencat generate a formatted message catalog file 

get get a version of an SCCS file 

getopt parse command options 

getprivgrp get special attributes for group 

grep, egrep, fgrep search a file for a pattern 

groups show group membership)s 

hashcheck (see spell(l)) 

hashmake (see spell(l)) 

head give first few lines 

help ask for help 

hostname set or print name of current host system 

hp handle special functions of HP 2640 and 2621-series terminals 

hp9000s200 (see machid(l)) 

hp9000s300 (see machid(l)) 

hp9000s500 (see machid(l)) 

hp9000s800 (see machid(l)) 

hpiutil (Series 800 only) ALLBASE/HP-UX HPIMAGE database utilities 

hyphen find hyphenated words 

id print user and group IDs and names 

insertmsg use findstr(l) output to insert calls to getmsg(3C) 

insf (Series 800 only) install special files 

inv (see vis(l)) 

iostat report I/O statistics 

ipcrm remove a message queue, semaphore set or shared memory id 

ipcs report inter-process communication facilities status 

iquery (Series 800 only) ALLBASE/HP-UX HPIMAGE database access interactive tool 

isl (Series 800 only) initial system loader 

isql (Series 800 only) ALLBASE/HP-UX interactive SQL interface 

join relational database operator 

kermit (Series 200/300 and 500 only) KERMIT protocol file transfer program 

kill terminate a process 

I (seels(l)) 

last, lastb indicate last logins of users and teletypes 

lastb (see last(l)) 

Id link editor 

leave remind you when you have to leave 

lex generate progrsims for lexical analysis of text 

lifcp copy to or from LIF files 

lifinit write LIF volume header on file 

lifls list contents of a LIF directory 

lifrename rename LIF files 

lifrm remove a LIF file 

line read one line from user input 

linkinfo (Series 500 only) object file link information utility 

lint a C program checker/verifier 

II (seels(l)) 

In (see cp(l)) 

lock reserve a terminal 
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login sign on 

logname get login name 

lorder find ordering relation for an object library 

Ip, cancel send/cancel requests to an LP line printer 

Ipstat print LP status information 

Is, 1, 11, Isf, Isr, Isx list contents of directories 

Isdev (Series 200/300 implementation) list device drivers in the system 

Isdev (Series 500 implementation) list device drivers in the system 

Isf (seels(l)) 

Isr (see ls(l)) 

Issf (Series 800 only) list a special file 

Isx (see ls(l)) 

m4 macro processor 

machid provide truth value about your processor type 

mail, rmail send mail to users or read mail 

mailx interactive message processing system 

make maintain, update, and regenerate groups of programs 

makekey generate encryption key 

man find manual information by keywords; print out the manual 

m£in (Series 300/500 Compressed Implementation) print compressed manual pages 

mediainit initialize hard disk, flexible disk, or cartridge tape media 

mesg permit or deny messages to terminal 

mkdir make a directory 

mksf (Series 800 only) make a special file 

mkstr extract error messages from C source into a file 

mm, osdd print/check docmnents formatted with the MM macros 

more, page file perusal filter for crt viewing 

mt magnetic tape manipulating program 

mv (see cp(l)) 

neqn format mathematical text for nroff 

newform change or reformat a text file 

newgrp log in to a new group 

news print news items 

nice run a conmiand at low priority 

nl line numbering filter 

nm print name list of common object file 

nm (Series 200/300 implementation) print name list (symbol table) of object file 

nm (Series 500 implementation) print name list (symbol table) of object file 

nohup nm a commEmd immune to hangups, logouts, and quits 

nroff format text 

od, xd octal and hexadecimal dump 

osdd (see mm(l)) 

pack, peat, unpack compress and expand files 

page (see more(l)) 

pam Personal Applications Manager, a visual shell 

passwd change login password 

paste merge same lines of several files or subsequent lines of one file 

pathalias electronic address router 

pc Pascal compiler 

p)cat (see pack(l)) 

pdb (see cdb(l)) 

pdpll (see machid(l)) 

pg file perusal filter for soft-copy terminals 

pr print files 

prealloc preallocate disk storage 
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primes (see factor(l)) 

prmail print out mail in the post office 

prof display profile data 

prs print and summarize an SCCS file 

ps report process status 

psqlc, psqlpas, psqlfor (Series 800 only) ALLBASE/HP-UX preprocessors for C, Pascal and FORTRAN 

ptx permuted index 

pwd working directory name 

query (Series 500 only) interactive IMAGE database access 

ratfor rational Fortran dialect 

red (see ed(l)) 

rev reverse lines of a file 

revision (Series 500 only) get HP-UX revision information 

rm, rmdir remove files or directories 

rmail (see mail(l)) 

rmdel remove a delta from an SCCS file 

rmdir (see rm(l)) 

rmnl remove extra new-line characters from file 

rsh (see sh(l)) 

rtprio execute process with realtime priority 

sact print current SCCS file editing activity 

sccsdiff compare two versions of an SCCS file 

sdb symbolic debugger 

sdfchmod change mode of an SDF file 

sdfchown, sdfchgrp change owner or group of an SDF file 

sdfcp, sdfln, sdfmv copy, link, or move files to/from £in SDF volume 

sdffind find files in an SDF system 

sdfll (seesdfls(l)) 

sdfln (see sdfcp(l)) 

sdfls, sdfll list contents of SDF directories 

sdftnkdir make an SDF directory 

sdfmv (see sdfcp(l)) 

sdfrm, sdfrmdir remove SDF files or directories 

sdfrmdir (see sdfrm(l)) 

sdiff side-by-side difference program 

sed stream text editor 

sh, rsh shell, the standard/restricted command programming language 

shl shell layer manager 

size print section sizes of object files 

sleep suspend execution for an interval 

sip set the options for a printer 

sort sort and/or merge files 

spell, hashmake, spellin, hashcheck find spelling errors 

spellin (see spell(l)) 

split split a file into pieces 

sqlutil (Series 800 only) ALLBASE/HP-UX DBCore utilities 

ssp remove multiple line-feeds from output 

strings find the printable strings in a object, or other binary, file 

strip (Series 200/300, 500) remove symbols and debug information 

strip (Series 800) strip symbol and line number information from an object file 

stty set the options for a terminal port 

stty (Series 300/500 Release 5.2 implementation) set the options for a terminal port 

su become super-user or another user 

sum print checksimi and block count of a file 

tabs set tabs on a terminal 
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tail deliver the last part of a file 

tar tape file archiver 

tbl format tables for nroff 

tcio Command Set 80 Cartridge Tape Utility 

tcio (Series 500 only) Command Set 80 Cartridge Tape Utility 

tee pipe fitting 

test condition evaluation command 

time time a command 

touch update access, modification, and/or change times of file 

tput query terminfo database 

tr translate characters 

true, false provide truth values 

tset terminal dependent initialization 

tsort topological sort 

tty get the name of the terminal 

tty (Series 300/500 Release 5.2 implementation) get the name of the terminal 

u3b (see machid(l)) 

u3b5 (see machid(l)) 

ul do underlining 

umask set file-creation mode mask 

umodem XMODEM-protocol file transfer program 

uname print name of current HP-UX version 

uncompact (see compact(l)) 

uncompress (see compress(l)) 

unexpand (see expand(l)) 

unget undo a previous get of an SCCS file 

uniq report repeated lines in a file 

units conversion program 

unpack (see pack(l)) 

upm (Series 500 only) unpack cpio archives from HP media 

uucp, uulog, uuname UNIX system to UNIX system copy 

uulog (see uucp(l)) 

uuname (see uucp(l)) 

uupick (see uuto(l)) 

uustat uucp status inquiry and job control 

uuto, uupick public UNIX system to UNIX system file copy 

uux UNIX system to UNIX system command execution 

uxgen (Series 800 only) generate an HP-UX system 

val validate SCCS file 

vax (see machid(l)) 

vc version control 

vi screen-oriented (visual) display editor based on ex 

vis, inv make unprintable characters in a file visible or invisible 

vmstat report virtual memory statistics 

vstat collect virtual memory performance statistics 

vt login to another system over Ian 

wait await completion of process 

wc word, line, cmd character count 

what identify files for SCCS information 

whereis locate source, binary, and/or manual for program 

which locate a program file including aliases and paths (csh(l) only) 

who who is on the system 

whoami print eff'ective current user id 

write interactively write (talk) to another user 

xargs construct £irgument list(s) and execute command 
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xd (see od(l)) 

xdb (Series 800 only) C, FORTRAN, and Pascal symbolic debugger 

yacc yet another compiler-compiler 

zcat (see compress(l)) 

9. Glossary 

intro introduction to the glossary 

glossary glossary of terms 



VOLUME 2 

IM. System Maintenance Utilities 

intro introduction to system maintenance commands and application programs 

accept, reject allow/prevent LP requests 

acct: acctdisk, acctdusg, accton, 

acctwtmp overview of accoimting sind miscellaneous accounting commands 

acctcms (see acct(lM)) 

acctconl, acctcon2 cormect-time accoimting 

acctdisk (see acct(lM)) 

acctdusg (see acct(lM)) 

acctmerg merge or add total accounting files 

accton (see acct(lM)) 

acctprcl, acctprc2 process accounting 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct, nuUadm, prctmp, prdaily, prtacct, 

runacct, shutacct, startup, tumacct shell procedures for accoimting 

acctwtmp (see acct(lM)) 

autobkup (Series 500 only) backup or archive file system 

backup (Series 200/300 implementation) backup or archive file system 

backup (Series 500 implementation) backup or archive file system 

bcheckrc (see brc(lM)) 

bifdf report nmnber of free disk blocks 

biffsck Bell file system consistency check and interactive repair 

biffsdb Bell file system debugger 

bifmkfs construct a Bell file system 

boot (Series 800 only) bootstrap process 

brc, bcheckrc, re, powerfail system initialization shell scripts 

captoinfo convert a termcap description into a terminfo description 

catman create the cat files for the manual 

catman (Series 300 and 500 Compressed Implementation) create compressed manual page cat files 

chargefee (see acctsh(lM)) 

chroot change root directory for a command 

chsys (Series 500 only) change to different operating system or version 

ckpacct (see acctsh(lM)) 

clri clear inode 

clrsvc clear x25 switched virtual circuit 

config (Series 200/300 only) configure an HP-UX system 

cpset install object files in binary directories 

cron clock daemon 

decode (Series 800 only) re2id and decode diagnostic events from the error log 

delog (Series 800 only) diagnostic event logger for I/O subsystem. 

devnm device name 
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df report number of free disk blocks 

disksecn (Series 800 only) calculate default disc section sizes 

diskusg generate disk accounting data by user ID 

dmesg collect system diagnostic messages to form error log 

dodisk (see acctsh(lM)) 

fsck ([HFS]) file system consistency check and interactive repair 

fsck ([SDF]) file system consistency check and interactive repair 

fsclean determine shutdown status of specified file system 

fsdb ([HFS]) file system debugger 

fsdb ([SDF]) file system debugger 

fwtmp, wtmpfix manipulate connect accounting records 

getty set terminal type, modes, speed, and line discipline 

getx25 get x25 line 

hpux (Series 800 only) (see hpuxboot(lM)) 

hpuxboot (Series 800 only) HP-UX bootstrap and installation utility 

init, telinit process control initialization 

install install commands 

isl (Series 800 only) initial system loader 

killall kill all active processes 

lastlogin (see acctsh(lM)) 

link, unlink exercise link and xmlink system calls 

Ipadmin configure the LP spooling system 

Ipmove (see Ipsched(lM) 

Ipsched, Ipshut, Ipmove start/stop the LP request scheduler and move requests 

Ipshut (see Ipsched(lM) 

mkdev make device files 

mvdevs (Series 300 only temporary command) move mass storage device files to /dtv subdirectories 

mkfs ([HFS]) construct a file system 

mklp configure the LP spooler subsystem 

mknod create special and fifo files 

mkrs (Series 200/300 and 500 only) construct a recovery system 

monacct (see acctsh(lM)) 

mount, umount ([HFS]) moimt £uid dismount file system 

moimt, umount ([non-HFS]) moimt and dismoimt file system 

mvdevs (temporary command for Series 300 Release 5.2 only) move disk/tape device files to /dtv subdirectories 

mvdir move a directory 

ncheck ([non-SDF]) generate names from i-numbers 

newfs ([HFS]) construct a new file system 

nulladm (see acctsh(lM)) 

opx25 execute HALGOL programs 

osck (Series 500 only) check integrity of OS in SDF boot area(s) 

oscp (Series 500 only) copy, create, append to, split operating system 

osmark (Series 500 only) mark SDF volume boot area as loadable/non-loadable 

osmgr (Series 500 only) operating system manager package description 

pdc (Series 800 only) Processor-dependent code 

powerfail (see brc(lM)) 

prctmp (see acctsh(lM)) 

prdaily (see acctsh(lM)) 

prtacct (see acctsh(lM)) 

pwck, grpck password/group file checkers 

re (see brc(lM)) 

reboot reboot the system 

reconfig (Series 300 only) configure an HP-UX system 

reject (see accept(lM)) 

revck (Series 200/300 and 500 only) check internal revision numbers of HP-UX files 
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rootmark (Series 500 only) mark/uiunark volume as HP-UX root volume 

nmacct nm daily accoimt'mg 

savecore save a core dump of the operating system 

sdfdf report number of free SDF disk blocks 

sdfFsck SDF file system consistency check, interactive repair 

sdfFsdb examine/modify an SDF file system 

sdfinit initialize Structured Directory Format volume 

setmnt establish mount table mnttab 

setprivgrp set special attributes for group 

shutacct (see acctsh(lM)) 

shutdown terminate all processing 

startup (see acctsh(lM)) 

stopsys (Series 500 only) stop operating system with optional reboot 

swapon ([HFS]) enable additional device for paging and swapping 

sync update the super block 

syncer periodically sync for file system integrity 

sysdiag (Series 800 only) on-line diagnostic system interface 

sysrm (Series 200/300 and 500 only) remove optional HP-UX products 

telinit (see init(lM)) 

tic terminfo compiler 

tunefs ([HFS]) tune up an existing file system 

tumacct (see acctsh(lM)) 

uconfig (Series 500 only) system reconfiguration 

umount (see moimt(lM)) 

unlink (see link(lM)) 

untie terminfo de-compiler 

update (Series 200/300, and 500 only) update optional HP-UX products 

uucico uucp copy in and copy out 

unclean uucp spool directory ciean-up 

uuls list spooled uucp transactions grouped by transaction 

uusnap show snap>shot of the UUCP system 

uusub monitor uucp network 

uuxqt uucp command execution 

vtdaemon respond to vt requests 

wall write to all users 

whodo which users are doing what 

wtmpfix (see fwtmp(lM)) 

2. System Calls 

intro introduction to system calls 

_exit (see exit(2)) 

access determine accessibility of a file 

acct enable or disable process accoimting 

alarm set a process's alarm clock 

brk, sbrk change data segment space allocation 

chdir change working directory 

chmod, fchmod change access mode of file 

chown, fchown change owner and group of a file 

chroot change root directory 

close close a file descriptor 

creat create a new file or rewrite an existing one 

dup duplicate an open file descriptor 

dup2 duplicate an open file descriptor to a specific slot 
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ems Extended Memory System 

errinfo (Series 500 only) error indicator 

ermo error indicator for system calls 

exec: execl, execv, execle, execve, execlp, execvp execute a file 

execl (see exec(2)) 

execle (see exec(2)) 

execlp (see exec(2)) 

execv (see exec(2)) 

execve (see exec(2)) 

execvp (see exec(2)) 

exit, exit terminate process 

fchmod (see chmod(2)) 

fchown (see chown(2)) 

fcntl file control 

fork create a new process 

fstat (see stat(2)) 

fsync synchronize a file's in-core state with its state on disk 

ftime get date and time more precisely 

ftruncate (see truncate(2)) 

getegid (see getuid(2)) 

geteuid (see getuid(2)) 

getgid (see getuid(2)) 

getgroups get group access list 

gethostname get name of current host 

getitimer, setitimer get/set value of interval timer 

getpgrp (see getpid(2)) 

getpgrp2 (see getpid(2)) 

getpid, getpgrp, getppid, getpgrp2 get process, process group, and parent process ID 

getppid (see getpid(2)) 

getprivgrp, setprivgrp get and set special attributes for group 

gettimeofday, settimeofday get/set date and time 

getuid, geteuid, getgid, getegid get real user, effective user, real group, and effective group IDs 

gtty (seestty(2)) 

ioctl control device 

kill send a signal to a process or a group of processes 

link link to a file 

lockf provide semaphores and record locking on files 

Iseek move read/write file pointer; (seek) 

memadvise advise OS about segment reference patterns 

memallc, memfree allocate and free address space 

memchmd change memory segment access modes 

memfree (see memallc(2)) 

memlck, memulck lock/unlock process address space or segment 

memulck (see memlck(2)) 

memvary modify segment length 

mkdir make a directory file 

mknod make a directory, or a special or ordinary file 

moimt mount a file system 

msgctl message control operations 

msgget get message queue 

msgop message operations 

nice change priority of a process 

open open file for reading or writing 

pause suspend process until signal 

pipe create an interprocess channel 
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plock lock process, text, or data in memory 

Drealloc preallocate fast disk storage 

profil execution time profile 

ptrace process trace 

read, readv read input 

readv (see read(2)) 

reboot boot the system 

rmdir remove a directory file 

rtprio change or read realtime priority 

sbrk (see brk(2)) 

select synchronous I/O multiplexing 

semctl semaphore control operations 

semget get set of semaphores 

semop semaphore operations 

setgid (see setuid(2)) 

setgroups set group access list 

sethostnfime set name of host cpu 

setitimer (see getitimer(2)) 

setpgrp, setpgrp2 set process group ID 

setpgrp2 (see setpgrp(2)) 

setprivgrp (see getprivgrp(2)) 

setresgid (see setresuid(2)) 

setresuid, setresgid set real, effective, and saved user and group IDs 

settimeofday (see gettimeofday(2)) 

setuid, setgid set user and group IDs 

shmctl shared memory control operations 

shmget get shared memory segment 

shmop shared memory operations 

sigblock block signals 

signed specify what to do upon receipt of a signal 

sigpause atomically release blocked signals and wait for interrupt 

sigsetmask set current signal mask 

sigspace assure sufficient signal stack space 

sigvector software signal facilities 

stat, fstat get file status 

stime set time and date 

stty, gtty control device 

swapon add a swap device for interleaved paging/swapping 

sync update super-block 

time get time 

times get process and child process times 

trapno (Series 500 only) hardware trap numbers 

trimcate, ftruncate truncate a file to a specified length 

ulimit get and set user limits 

umask set and get file creation mask 

umount unmount a file system 

uname get name of current HP-UX system 

unlink remove directory entry; delete file 

ustat get file system statistics 

utime set file access and modification times 

vfork spawn new process in a virtual memory efficient way 

vsadv advise system about backing store usage 

vsoff (see vson(2)) 

vson, vsoff advise OS about backing store devices 

wait wait for child process to stop or terminate 
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write, writev write on a file 

writev (see write(2)) 



3. Subroutines 

intro introduction to subroutines and libraries 

_tolower (see conv(3C)) 

_toupper (see conv(3C)) 

a641, 164a convert between long integer and base-64 ASCII string 

abort generate an lOT fault 

abs return integer absolute value 

acos (see trig(3M)) 

asctime (see ctime(3C)) 

asin (see trig(3M)) 

assert verify program assertion 

atan (see trig(3M)) 

atan2 (see trig(3M)) 

atof (see strtod(3C)) 

atoi (see strtol(3C)) 

atol (see strtol(3C)) 

bessel: jO, jl, jn, yO, yl, yn Bessel functions 

blmode terminal block mode library interface 

bsesirch binary search a sorted table 

calloc (see malloc(3C)) 

calloc (see malloc(3X)) 

catread MPE/RTE-style message catalog support 

ceil (see floor(3M)) 

chpibegin (Series 800 only) (see HPIMAGE(3X)) 

chpiclose (Series 800 only) (see HPIMAGE(3X)) 

chpicontrol (Series 800 only) (see HPIMAGE(3X)) 

chpidelete (Series 800 only) (see HPIMAGE(3X)) 

chpiend (Series 800 only) (see HPIMAGE(3X)) 

chpierror (Series 800 only) (see HPIMAGE(3X)) 

chpifind (Series 800 only) (see HPIMAGE(3X)) 

chpifindset (Series 800 only) (see HPIMAGE(3X)) 

chpiget (Series 800 only) (see HPIMAGE(3X)) 

chpiinfo (Series 800 only) (see HPIMAGE(3X)) 

chpilock (Series 800 only) (see HPIMAGE(3X)) 

chpimemo (Series 800 only) (see HPIMAGE(3X)) 

chpiopen (Series 800 only) (see HPIMAGE(3X)) 

chpiput (Series 800 only) (see HPIMAGE(3X)) 

chpiundo (Series 800 only) (see HPIMAGE(3X)) 

chpiupdate (Series 800 only) (see HPIMAGE(3X)) 

clearerr (see ferror(3S)) 

clock report CPU time used 

closedir (see directory (3C)) 

conv: toupper, tolower, _toupper, _tolower translate characters 

cos (see trig(3M)) 

cosh (see sinh(3M)) 

CRTO (Series 300 only) execution startup routines 

crtO.o (Series 300 only) (see CRT0(3)) 

crypt, setkey, encrypt generate hashing encryption 

ctermid generate file name for terminal 

ctime, nl ctime, localtime, gmtime, asctime, 
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nl_asctiine, timezoue, daylight, tzname, tzset convert date and time to string 

ctype classify characters 

cnrrlangid (see langinfo(3C)) 

curses CRT screen handling and optimization package 

cuserid get character login name of the user 

cvtnum (Series 300 only) convert string to floating point number 

datalock lock process into memory, after allocating data and stack space 

daylight (see ctime(3C) 

dial, undial establish an out-going terminal line connection 

directory: opendir, readdir, telldir, seekdir, rewinddir, closedir directory operations 

drand48, erand48, lrand48, nrand48, mrand48, jrand48, 

srand48, 8eed48, lcong48 generate uniformly distributed pseudo-random numbers 

ecvt, fcvt, gcvt, nl gcvt convert floating-point number to string 

edata (see end(3C) 

encrypt (see crypt(3C) 

end, etext, edata last locations in program 

endfsent (see getf8ent(3X) 

endgrent (see getgrent(3C) 

endpwent (see getpwent(3C) 

erand48 (see drand48(3C) 

erf, erfc error function and complementary error function 

ermo (see perror(3C) 

etext (see end(3C) 

exp, log, loglO, pow, sqrt exponential, logarithm, power, square root fimctions 

fabs (see floor(3M) 

fclose, fflush close or flush a stream 

fcvt (see ecvt(3C) 

fdopen (see fopen(3S) 

feof (see ferror(3S) 

ferror, feof, clearerr, flleno stream status inquiries 

fflush (see fclo8e(3S) 

fgetc (see getc(3S) 

fgetgrent (see getgrent(3C) 

fgetpwent (see getpwent(3C) 

fgets (see gets(3S) 

fileno (see ferror(3S) 

floor, ceil, fmod, fabs floor, ceiling, remainder, absolute value functions 

fmod (see floor(3M) 

fopen, fi-eopen, fdopen open or re-open a stream file; convert file to stream 

fprintf (see printf(3S) 

fprintmsg (see printmsg(3C) 

fputc (see putc(3S) 

fputs (see puts(3S) 

fread, fwrite buffered binary input/output to a stream file 

free (see malloc(3C) 

free (see malloc(3X) 

freopen (see fopen(3S) 

frexp, Idexp, modf split floating-point into mantissa and exponent 

frtO.o (Series 300 only) (see CRT0(3) 

fscanf (see scanf(3S) 

fseek, rewind, ftell reposition a file pointer in a stream 

ftell (see fseek(3S) 

ftok (see stdipc(3C) 

ftw walk a file tree 

fwrite (see fread(3S)) 
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gamma, signgam log gamma function 

gcvt (see ecvt(3C)) 

getc, getchar, fgetc, getw get charsicter or word from a stream file 

getchar (see getc(3S)) 

getcwd get path-name of current working directory 

getenv return value for environment name 

getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent get file system descriptor file entry 

getfsfile (see getfsent(3X)) 

getfsspec (see getfsent(3X)) 

getfstype (see getfsent(3X)) 

getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent get group file entry 

getgrgid (see getgrent(3C)) 

getgrnam (see getgrent(3C)) 

getlogin get login name 

getmsg get message from a catalog 

getopt, optarg, optind, opterr get option letter from argument vector 

getpass read a password 

getpw get name from UID 

getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent get password file entry 

getpwnam (see getpwent(3C)) 

getpwuid (see getpwent(3C)) 

gets, fgets get a string from a stream 

getut: getutent, getutid, getutline, pututline, setutent, endutent, utmpname access utmp file entry 

getutent (see getut(3C)) 

getutid (see getut(3C)) 

getw (see getc(3S)) 

gmtime (see ctime(3C)) 

gpio get status return status lines of GPIO card 

gpio set ctl set control lines on GPIO card 

gsignal (see ssignal(3C)) 

hcreate (see hsearch(3C)) 

hdestroy (see hsearch(3C)) 

hpib_abort stop activity on specified HP-IB bus 

hpib_bus__status return status of HP-IB interface 

hpib card ppoll resp control response to parallel poll on HP-IB 

hpib eoi ctl control EOT mode for HP-IB file 

hpib io perform I/O with an HP-IB chsinnel from buffers 

hpib_pass_ctl change active controllers on HP-IB 

hpib ppoll conduct parallel poll on HP-IB bus 

hpib_ppoll resp_ctl Define interface parallel poll response 

hpib ren ctl control the Remote Enable line on HP-IB 

hpib rqst srvce allow interface to enable SRQ line on HP-IB 

hpib send cmnd send command bytes over HP-IB 

hpib spoil conduct a serial poll on HP-IB bus 

hpib status wait wait until the requested status condition becomes true 

hpib wait_on ppoll wait until a particular parallel poll Vcilue occurs 

HPIMAGE(3X) (Series 800 only) ALLBASE/HP-UX HPIMAGE programmatic calls 

hpibegin (Series 800 only) (see HPIMAGE(3X)) 

hpiclose (Series 800 only) (see HPIMAGE(3X)) 

hpicontrol (Series 800 only) (see HPIMAGE(3X)) 

hpidelete (Series 800 only) (see HPIMAGE(3X)) 

hpiend (Series 800 only) (see HPIMAGE(3X)) 

hpierror (Series 800 only) (see HPIMAGE(3X)) 

hpifind (Series 800 only) (see HPIMAGE(3X)) 

hpifindset (Series 800 only) (see HPIMAGE(3X)) 
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hpiget (Series 800 only) (see HPIMAGE(3X)) 

hpiinfo (Series 800 only) (see HPIMAGE(3X)) 

hpilock (Series 800 only) (see HPIMAGE(3X)) 

hpimemo (Series 800 only) (see HPIMAGE(3X)) 

hpiopen (Series 800 only) (see HPIMAGE(3X)) 

hpiput (Series 800 only) (see HPIMAGE(3X)) 

hpiundo (Series 800 only) (see HPIMAGE(3X)) 

hpiupdate (Series 800 only) (see HPIMAGE(3X)) 

hsearch, hcreate, hdestroy manage hash search tables 

hypot Euclidean distance function 

idtolang (see langinfo(3C)) 

initgroups initialize group access list 

intrapofF, intrapon (Series 500 only) disable/enable integer trap handler 

intrapon (Series 500 only) (see intrapofF(3M)) 

io_burst perform low-overhead I/O on an HP-IB/GPIO channel 

io_eol ^ctl set up read termination character on special file 

io_get_term reason determine how last read terminated 

io interrupt ctl enable/disable interrupts for the associated eid 

io lock, io_unlock lock and unlock an interface 

io_on interrupt device interrupt (fault) control 

io reset reset an I/O interface 

io__speed ctl inform system of required transfer speed 

io_timeout_ctl establish a time limit for I/O operations 

io_imlock (see io_Jock(3I)) 

io_width ctl set width of data path 

isalnum (see ctype(3C) 

isalpha (see ctype(3C) 

isascii (see ctype(3C) 

isatty (see ttyname(3C) 

iscntrl (see ct)T)e(3C) 

isdigit (see ctype(3C) 

isgraph (see ctype(3C) 

islower (see ctype(3C) 

isprint (see ctype(3C) 

ispunct (see ctype(3C) 

isspace (see ctype(3C) 

isupper (see ctype(3C) 

isxdigit (see ctype(3C) 

jO, jl, jn (see bessel(3M) 

jrand48 (see drand48(3C) 

13tol, ltol3 convert between 3-byte integers and long integers 

164a (seea641(3C) 

langinfo, langtoid, idtolang, currlangid information on user's native language as given by NLS 

langtoid (see langinfo(3C) 

lcong48 (see drand48(3C) 

Idexp (see frexp(3C) 

Ifind (see lsearch(3C) 

localtime (see ctime(3C) 

log (see exp(3M) 

loglO (see exp(3M) 

logname return login name of user 

longjmp (see setjmp(3C) 

lrand48 (see drand48(3C) 

Isearch, Ifind linear search and update 

ltol3 (see 13tol(3C)) 
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mallinfo (see maIloc(3X)) 

malloc, free, realloc, calloc (3C) mam memory allocator 

malloc, free, realloc, calloc, mallopt, mallinfo (3X) fast main memory allocator 

mallopt (see malloc(3X)) 

matherr error-handling function 

mcrtO.o (Series 300 only) (see CRT0(3)) 

memchr (see memory(3C)) 

memcmp (see memory(3C)) 

memcpy (see memory(3C)) 

memory: memccpy, memchr, memcmp, memcpy, memset memory operations 

memset (see memory(3C)) 

mfrtO.o (Series 300 only) (see CRT0(3)) 

mktemp make a miique file name 

modf (see frexp(3C)) 

monitor prepare execution profile 

mrand48 (see drand48(3C)) 

nL_asctime (see ctime(3C)) 

nl_atof (see strtod(3C)) 

nl conv: nl ^toupper, nl tolower translate characters for use with NLS 

nL^time (see ctime(3C)) 

nl retype: nl isalpha, nl isupper, nl_islower, nl isalnum, nl ispunct, 

nl isprint, nl isgraph classify characters for use with NLS 

nl gcvt (see ecvt(3C)) 

nl_Jsalnum (see nl_ctype(3C)) 

nl_isalpha (see nL_ctype(3C)) 

nl_isdigit (see nl_ctype(3C)) 

nl_isgraph (see nL_ctype(3C)) 

nl—islower (see nL_ctype(3C)) 

nl—isprint (see nL_ctype(3C)) 

nl_ispunct (see nl_ctype(3C)) 

nl isupper (see nL_ctype(3C)) 

nl—isxdigit (see nL_ctype(3C)) 

nl string: strcmpS, stmcmpS, strcmpl6, stmcmpl6 non-ASCII string collation 

nl strtod (see strtod(3C)) 

nl_tolower (see nl_conv(3C)) 

nl tools 16 tools to process 16-bit characters 

nl toupper (see nl conv(3C)) 

nlist get entries from name list 

nrand48 (see drand48(3C)) 

opendir (see directory(3C)) 

optarg (see getopt(3C)) 

opterr (see getopt(3C)) 

optind (see getopt(3C)) 

pclose (see pop)en(3S) 

perror, ermo, sys_errlist, sys_nerr system error messages 

popen, pclose initiate pipe I/O to/from a process 

pow (see exp(3M)) 

printf, fprintf, sprintf print formatted output 

printmsg, ^rintmsg, sprintmsg print formatted output with numbered arguments 

putc, putchar, fputc, putw put character or word on a stream 

putchar (see putc(3S)) 

putenv change or add value to environment 

putpwent write password file entry 

puts, ^uts put a string on a stream 

putw (see putc(3S)) 
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qsort quicker sort 

rand, srand simple random-number generator 

readdir (see directory(3C)) 

realloc (see malloc(3C)) 

realloc (see malloc(3X)) 

regcmp, regex compile and execute regular expression 

regex (see regcmp(3X) 

rewind (see fseek(3S)) 

rewinddir (see directory (3C)) 

scanf, fscanf, sscanf formatted input conversion, read from stream file 

seed48 (see drand48(3C)) 

seekdir (see directory(3C)) 

setbuf, setvbuf assign buffering to a stream file 

setfsent (see getfsent(3X)) 

setgrent (see getgrent(3C)) 

setjmp, longjmp non-local goto 

setkey (see crypt(3C)) 

setpwent (see getpwent(3C)) 

setvbuf (see setbuf(3S)) 

sgetl (see sputl(3X)) 

signgam (external variable - see gamma(3M)) 

sin (see trig(3M)) 

sinh, cosh, tanh hyperbolic functions 

sleep suspend execution for interval 

sprintf (see printf(3S)) 

sprintmsg (see printmsg(3C)) 

sputl, sgetl access long integer data in a machine-independent fashion 

sqrt (see exp(3M)) 

srand (see rand(3C)) 

srand48 (see drand48(3C)) 

sscanf (see scanf(3S)) 

ssignal, gsignal software signals 

stdio standard buffered input/output stream file package 

stdipc: ftok standard interprocess communication package 

strcat (see string(3C)) 

strchr (see string(3C)) 

strcmp (see string(3C)) 

strcmpie (see nL_jstring(3C)) 

strcmp8 (see nl__string(3C)) 

strcpy (see string(3C)) 

strcspn (see 8tring(3C)) 

string translate characters 

string: strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, 

strchr, strrchr, strpbrk, strspn, strcspn, strtok character string operations 

strlen (see string(3C)) 

strncat (see string(3C)) 

strncmp (see string(3C)) 

stmcmpie (see nl_string(3C)) 

stmcmpS (see nl_8tring(3C)) 

strncpy (see string(3C)) 

strpbrk (see string(3C)) 

strrchr (see string(3C)) 

strspn (see string(3C)) 

strtod, atof, nl strtod, nl atof convert string to double-precision niunber 

strtok (see string(3C)) 
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strtol, atol, atoi convert string to integer 

swab swap bytes 

sys_errlist (see perror(3C)) 

sys__nerr (see p€rror(3C)) 

system issue a shell command 

tan (see trig(3M)) 

tanh (see sinh(3M)) 

tdelete (see tsearch(3C)) 

telldir (see directory(3C)) 

tempnam (see tmpnam(3S)) 

termcap: tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs emulate /etc/termcap access routines 

tfind (see tsearch(3C)) 

tgetent (see termcap(3X)) 

tgetflag (see termcap(3X)) 

tgetnum (see termcap(3X)) 

tgetstr (see termcap(3X)) 

tgoto (see termcap(3X)) 

timezone (see ctime(3C)) 

tmpfile create a temporary file 

tmpnam, tempnam create a name for a temporary file 

toascii (see conv(3C)) 

tolower (see conv(3C)) 

toupper (see conv(3C)) 

tputs (see termcap(3X)) 

trig: sin, cos, tan, asin, acos, atan, atan2 trigonometric functions 

tsearch, tfind, tdelete, twalk manage binary search trees 

ttyname, isatty find name of a terminal 

ttyslot find the slot in the utmp file of the current user 

twalk (see tsearch(3C)) 

tzname (see ctime(3C)) 

tzset (see ctime(3C)) 

undial (see dial(3C)) 

ungetc push character back into input stream 

vfprintf (see vprintf(3S)) 

vprintf, vfprintf, vsprintf print formatted output of a varargs argument list 

vsprintf (see vprintf(3S)) 

yO, yl, yn (see bessel(3M)) 

4. File Formats 

intro introduction to file formats 

a.out £issembler and link editor output 

a.out (Series 200/300 implementation) assembler and link editor output 

a.out (Series 500 implementation) executable linker output file 

a.out (Series 800 only) assembler and link editor output 

acct per-process accounting file format 

ar common archive file format 

bif bell interchange format utilities 

btmp (see utmp(4)) 

checklist static information about the file systems 

col^eq_8 collating sequence table for languages with 8-bit character sets 

core format of core image file 

core (Series 200/300 Implementation) format of core image file 

core (Series 500 Implementation) format of core image file 
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cpio format of cpio archive 

d ^passwd (see dialups(4)) 

devices (Series 800 only) file of driver information for insf, mksf, Issf 

dialups, d passwd dialup security control 

dir[HFS] format of directories 

dir[SDF] (Series 500 Implementation) format of directories 

disktab disk description file 

dosif (Series 300 only) DOS Interchange Format description 

errfile (Series 500 Implementation) system error logging file 

fs[HFS] format of file system volume 

fs[SDF] (Series 500 only) format of system volume 

fspec format specification in text files 

gettydefs speed and terminal settings used by getty 

group group file, grp.h 

inittab script for the init process 

inode[HFS] format of an inode 

inode([SDF] Series 500 Implementation) format of an i-node 

issue issue identification file 

lif logical interchange format description 

magic magic numbers for HP-UX implementations 

master (Series 200/300 only) master device information table 

mknod create a special file entry 

mnttab mounted file system table 

model HP-UX machine identification 

nlist nlist structure format 

passwd password file, pwd.h 

privgrp format of privileged values 

profile set up user's environment at login time 

ranlib (Series 200/300 and 500 only) archive symbol table format for object libraries 

sccsfile format of SCCS file 

sdf structured directory format description 

term format of compiled term file 

terminfo terminal capability data hase 

ttytype data base of terminal types by port 

tztab time zone adjustment table for date(l) and ctime(3C) 

utmp, wtmp, btmp utmp, wtmp, btmp entry format 

wtmp (see utmp(4)) 

5. Miscellaneous Facilities 

intro introduction to miscellany 

advance (see regexp(5)) 

ascii map of ASCII cheiracter set 

compile (see regexp(5)) 

environ user environment 

ERROR (see regexp(5)) 

fcntl file control options 

GETC (see regexp(5)) 

hier file system hierarchy 

hpnls HP Native Language Support (NLS) Model 

INIT (see regexp(5)) 

ioctl generic device control commsmds 

kana8 map of KanaS kateikana character set 

langid language identification variable 
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man macros for formatting entries in this manual 

math math functions and constants 

mm the MM macro package for formatting documents 

PEEKC (see regexp(5)) 

prof profile within a function 

regexp: INIT, GETC, PEEKC, UNGETC, RETURN, ERROR, 

compile, step, advance regular expression compile and match routines 

RETURN (see regexp(5)) 

romanS map of RomanS character set 

Stat data returned by stat/fetat system call 

step (see regexp(5)) 

term conventional names for terminals 

types primitive system data types 

UNGETC (see regexp(5)) 

values machine-dependent values 

varargs handle variable argument list 



6. Games 

No games are currently supported. 

7. Special Files 

intro introduction to special files 

CRT graphics (Series 200/300 only) (see graphics(7)) 

afi (Scries 800 only) (see gpio(7)) 

console system console interface 

ct cartridge tape access 

diagO (Series 800 only) diagnostic interface to I/O subsystem 

disk direct disk access 

gpio (Series 800 only) asynchronous FIFO interface 

graphics: CRT graphics (Series 200/300 only) information for CRT graphics devices 

hpib Hewlett-Packard Interface Bus driver 

iomap (Series 200/300 only) physical address mapping 

kmem (see mem(7)) 

Ip line printer 

mem, kmem main memory 

modem asynchronous serial modem line control 

mt magnetic tape interface and controls 

null null file 

pty pseudo terminal driver 

stty (see 8ttyV6(7)) 

sttyV6 terminal interface for Version 6/PWB compatibility 

termio general terminal interface 

tty controlling terminal interface 

9. Glossary 

The glossary is located in Volume 1 after Section 1. 
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NAME 

intro - introduction to command utilities and application programs 

DESCRIPTION 

This section describes commands accessible by users, as opposed to system calls in Section (2), or 
subroutines in Section (3), which are accessible by user programs. 

Command Syntax 

Unless otherwise noted, commands described in this section accept options and other argiunents 
according to the following syntax: 

name [option{s)] [cmdarg{s)] 

where: 

name The name of an executable file. 

option - noargletter{s) or, 

- ar^etterooptarg 
where <> is optional white space. 

noargletter A single letter representing an option without an argument. 

argletter A single letter representing an option requiring an argument. 

optarg Argument (character string) satisfying preceding argletter. 

cmdarg Path name (or other command argument) not beginning with - or, - by itself 

indicating the standard input. 

DIAGNOSTICS 

Upon termination, each command returns two bjrtes of status, one supphed by the system and 
giving the cause for termination, and (in the case of "normal" termination) one supplied by the 
program (for example, see vmit{2) and exit{2)). The former byte is for normal termination; the 
latter is customarily for successful execution and non-zero to indicate troubles such as erroneous 
parameters, bad or inaccessible data. It is called variously "exit code", "exit status", or "return 
code", and is described only where special conventions are involved. 

WARNINGS 

Some commands produce unexpected results when processing files containing null characters. 
These commands often treat text input lines as strings and therefore become confused upon 
encountering a null character (the string terminator) within a line. 

SEE ALSO 

getopt(l), exit(2), wait(2), getopt(3C), hier(5). 
The introduction to this manual. 
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NAME 

acctcom - search and print process accoiinting file(s) 

SYNOPSIS 

acctcom [[options] [file]] . . . 

DESCRIPTION 

Acctcom reads file, the standard input, or /usr/adm/pacct, in the form described by acct{4) 
and writes selected records to the standjird output. Each record represents the execution of one 
process. The output shows the COMMAND NAME, USER, TTYNAME, START TIME, END 
TIME, REAL (SEC), CPU (SEC), MEAN SIZE(K), and optionally, F (the fork/ exec flag: 1 
for fork without exec), STAT (the system exit status), HOG FACTOR, KCORE MIN, CPU 
FACTOR, CHARS TRNSFD, and BLOCKS READ (total blocks read and written). 

The command name is prepended with a # if it was executed with super-user privileges. If a pro- 
cess is not associated with a known terminal, a ? is printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a terminal or /dev/nuU (as is 
the case when using ic m the shell), /usr/adm/pacct is read; otherwise, the standard input is 
read. 

If any file arguments are given, they are read in their respective order. Each file is normally read 
forward, i.e., in chronological order by process completion time. The file /usr/adm/pacct is 
usually the current file to be examined; a busy system may need several such files of which all but 
the current file are found in /usr/adm/pacct ?. The options are: 

-a Show some average statistics about the processes selected. The statistics will be 

printed after the output records. 
-b Read backwards, showing latest commands first. This option has no effect when 

the standard input is read. 
-f Print the fork /exec flag and system exit status columns in the output. 

-h Instead of mean memory size, show the fraction of total available CPU time con- 

sumed by the process during its execution. This "hog factor" is computed as: 
(total CPU time) /(elapsed time). 
-i Print colmnns containing the I/O coimts in the output. 

-k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor (user time/ (system-time + user-time). 

-t Show separate system and user CPU times. 

-V Exclude column headings from the output. 

-1 line Show only processes belonging to terminal /dew /line. 

-u user Show only processes belonging to user that may be specified by: a user ID, a 

login name that is then converted to a user ID, a # which designates only those 

processes executed with super-user privileges, or ? which designates only those 

processes associated with imknown user IDs. 
-g group Show only processes belonging to group. The group may be designated by either 

the group ID or group name, 
-s time Select processes existing at or after time , given in the format hr [ : min \:sec\\. 

-e time Select processes existing at or before time . 

-S time Select processes starting at or after time . 

-E time Select processes ending at or before time . Using the same time for both -S and 

-E shows the processes that existed at time. 
-n pattern Show only commands matching pattern that may be a regular expression as in 

erf(l) except that •{■ means one or more occurrences. 
-q Do not print any output records, just print the average statistics as with the -a 

option. 
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— o ofile Copy selected process records in the input data format to ofile\ supress standard 

output printing. 
-H factor Show only processes that exceed factor, where factor is the "hog factor" as 

explained in option -h above. 
-O time Show only those processes with operating system CPU time that exceeds time. 

-C sec Show only processes with total CPU time, system plus user, exceeding aec 

seconds. 
-I chars Show only processes transferring more characters than the cut-off number given 

by chars. 

Listing options together has the effect of a logical and. 

FILES 

/etc/group 

/usr/adm/pacct 

/etc/passwd 

SEE ALSO 

acct(^lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), ps(l), 
runacct(lM), su(l), acct(2), acct(4), utmp(4). 

BUGS 

Acctcom only reports on processes that have terminated; use ps(l) for active processes. If time 
exceeds the present time, then time is interpreted as occurring on the previous day. 
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For most commands 
The default count is 1. Address 



NAME 

adb - debugger 

SYNOPSIS 

adb [ -w ] [ -Idir ] [ objfil ( corfil ] ] 

DESCRIPTION 

Adb ia a general piu-pose debugging program sensitive to the imderlying architecture of the proces- 
sor upon which it is running. It may be used to examine files and to provide a controlled environ- 
ment for the execution of HP-UX programs. 

Objfil is normally an executable program file, preferably containing a symbol table; if not then the 
symbolic features of adb cannot be used although the file can still be examined. The default for 
objfil is a.out. Corfil is assimied to be a core image file produced after executing objfil; the 
default for corfil is core. 

Requests to adb are read firom the standard input and responses are to the standard output. If 
the -w flag is present then objfil is created if necessary and opened for reading and writing so 
that it can be modified using adb. The -I option specifies a directory where files to be read with 
$< or $« (see below) will be sought; the default is /usr/lib/adb. Adb ignores QUIT; INTER- 
RUPT causes retiun to the next adb command. 

In general requests to adb are of the form: 

[address] [, count] [command] [;] 

If address is present then dot is set to address. Initially dot is set to 
count specifies how many times the command will be executed 
and count are expressions. 

The interpretation of an address depends on the context in which it is used. If a subprocess is 
being debugged then addresses are interpreted in the usual way in the address space of the sub- 
process. For further details of address mapping see Addresses below. 

Expressions 

The value of dot. 

+ The value of dot incremented by the current increment. 

The value of dot decremented by the current increment. 

The last address typed. 

integer A nimaber. The prefixes Oo and OO (zero oh) force interpretation in octal radix; 

the prefixes Ot, OT, Od and OD force interpretation in decimal radix; the prefixes 
Ox and OX force interpretation in hexadecimal radix. Thus Oo20 = 0tl6 = 0x10 
= sixteen. If no prefix appears, then the default radix is used; see the $d com- 
mand. The radix is initialized to the base normally used in the assembly 
language for the processor involved. Note that a hexadecimal mmiber whose 
most significant digit would otherwise be an alphabetic character must have a Ox 
(or OX) prefix (or a leading zero if the default radix is hexadecimal). 

integer. fraction A 32-bit floating point mmiber. 

iccccf The ASCn value of up to 4 characters. A \ may be used to escape a /. 

< name The value of name, which is either a variable name or a register name. Adb 

maintains a number of variables named by single letters or digits, see Variables 
below. If name is a register name then the value of the register is obtained firom 
the system header in corfil (before the subprocess is initiated) or from the sub- 
process' user area. The register names are implementation dependent; see the $r 
command. 
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symbol A symbo! is a sequence of upper or lower case letters, underscores or digits, not 

starting with a digit. The value of the symbol is taken from the sjrmbol table in 
objfil. An initial _ will be prefixed to symbol if needed. 

_ symbol If the compiler prefixes a _ to an external symbol, it may be necessary to utter 

this name to distinguish it from a symbol generated in assembly language. 

{exp ) The value of the expression exp. 

The monadic operators are: 

*exp The contents of the location addressed by exp in corfil. 

@ exp The contents of the location addressed by exp in objfil. 

-exp Integer negation. 

~exp Bitwise complement. 
The dyadic operators are left associative and are less binding than monadic operators: 

el+e8 Integer addition. 

el—e2 Integer subtraction. 

el*e2 Integer multiplication. 

el%e2 Integer division. 

elkeS Bitwise conjunction. 

el\eS Bitwise disjimction. 

elif:e8 El roimded up to the next multiple of e8. 

Commands 

Most commands consist of a verb followed by a modifier or fist of modifiers. The following verbs 
can take format specifiers. (The commands ? and / may be followed by *; see Addresses for 
further details.) 

?/ Locations starting at address in objfil are printed according to the format /. dot 

is incremented by the siun of the increments for each format letter. If a subpro- 
cess has been initiated, address references a location in the subprocess' address 
space instead of objfil. 

// Locations starting at address in corfil are printed according to the format / and 

dot is incremented as for ?. If a subprocess has been initiated, address references 
a location in the subprocess' address space instead of corfil. 

=/ The value of address itself is printed in the styles indicated by the format /. 

(For i format ? is printed for the parts of the instruction that reference subse- 
quent words.) 

A format consists of one or more characters that specify a style of printing. Each format charac- 
ter may be preceded by an integer that is a repeat coimt for the format character. While stepping 
through a format, dot is incremented by the amount given for each format letter. If no format is 
given then the last format is used. 

The format letters available are as follows: 

o 2 Print 2 bytes in octal. All octal numbers output by adb are preceded by 

0. 

O 4 Print 4 bytes in octal. 

q 2 Print 2 bytes in signed octal. 
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Q 4 Print 4 bytes in signed octal. 

d 2 Print 2 bytes in decimal. 

D 4 Print 4 bytes in decimal. 

X 2 Print 2 bytes in hexadecimal. 

X 4 Print 4 bytes in hexadecimal. 

u 2 Print 2 bytes as an misigned decimal number. 

U 4 Print 4 bytes as an imsigned decimal nmnber. 

f 4 Print the 32 bit value as a floating point nimiber. 

F 8 Print double floating point. 

b 1 Print the addressed byte in hexadecimal. 

B 1 Print the addressed byte in octal. 

c 1 Print the addressed character. (The sign bit is ignored.) 

C 1 Print the addressed character using the following escape convention. 

First, the sign bit is discarded, then character values 000 to 040 are 
printed as @ followed by the corresponding character in the range 0100 
to 0140. The character @ is printed as @@. 

s n Print the addressed characters imtil a zero character is reached. 

S n Print a string using the @ escape convention. The v£ilue n is the length 

of the string including its zero terminator. 

Y 4 Print 4 bytes in date format (see cfime (3C)). 

i n Print as machine instructions. The value of n is the number of bytes 

occupied by the instruction. 

a Print the value of dot in symbolic form. 

p n Print the addressed value in symbolic form. The value of n is a machine 

dependent constant. 

t When preceded by an integer, tabs to the next appropriate tab stop. 

For example, 8t moves to the next 8-space tab stop. 

r Print a space. 

n Print a new-line. 

"..." Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 

+ Dot is incremented by 1. Nothing is printed. 

- Dot is decremented by 1. Nothing is printed. 

new-line Repeat the previous command with a count of 1. New-line can also be used to 

repeat a :8 or :c command; any argmnents to the previous command, however, 
are lost. 

[?/]l value mask Words starting at dot are masked with mask and compared with value imtil a 
match is found. If L is used then the match is for 4 bytes at a time instead of 2. 
If no match is foimd then dot is unchanged; otherwise dot is set to the matched 
location. If mask is omitted then -1 is used. 

[?/]w value ... Write the 2-byte value into the addressed location. If the command is W, write 
4 bytes. Odd addresses are not allowed when writing to the subprocess address 
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name 

I 



space. 

?/]m bl el /i[?/] 

New values for {bl, el, fl) are recorded. If less than three expressions are given 
then the remaining map parameters are left unchanged. If the ? or / is followed 
by * then the second segment {b8, e8,f2) of the mapping is changed. If the list 
is terminated by ? or / then the file {objfil or corfil, respectively) is used for sub- 
sequent requests. (So that, for example, /m? will cause / to refer to objfil.) 

Dot is assigned to the variable or register named. 

A sheU is called to read the rest of the line following !. 

The available $ commands are: 

Read commands from the file /. If this command is executed in a file, 
further commands in the file are not seen. If a count is given, and is 
zero, the command will be ignored. The value of the count will be 
placed in variable 9 before the first command in / is executed. 

Similar to $< except it can be used in a file of conmiands without caus- 
ing the file to be closed. Variable 9 is saved during the execution of this 
command, and restored when it completes. Only five $<< files can be 
open at once. 

Send output to the file /, which is created if it does not exist. 

Print the general registers and the instruction addressed by the process 
coimter. Dot is set to the process coimter contents. 

Print the floating point registers in an appropriate machine-dependent 
manner. 



^modifier 



$«/ 



$>/ 
$r 



$b 



$e 
$w 
$s 



$d 



$x 
$q 

$v 
$in 

$new-line 



Print all breakpoints and their associated counts and commands. 

C stack backtrace. If address is given then it is taken as the address of 
the current frame (instead of the normal stack frame pointer). If count 
is given then only the first count frames are printed. 

The names and values of external variables are printed. 

Set the page width for output to address (default 80). 

Set the limit for symbol matches to address. The default is system 
dependent. 

The default for all integers input is octal. 

Set the default radix to address and report the new value. Note that 
address is interpreted in the (old) current radix. Thus 10$d never 
changes the default radix. To make decimal the default radix, use 
OtlOSd. 

The default for all integers input is hexadecimal. 

lixit from adb. 

Print all non-zero variables in the cm-rent radix. 

Print the address map. 

print the process id and register values. 



•.modifier The available : commands, which manage subprocesses, are: 

:bc Set breakpoint at address. The breakpoint is executed count-1 times 

before causing a stop. Each time the breakpoint is encountered the 
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command c is executed. If this command sets dot to zero then the 
breakpoint causes a stop. 

:d Delete breakpoint at address. :d* will delete all breakpoints. 

:r Run objfil as a subprocess. If address is given explicitly then the pro- 

gram is entered at this point; otherwise the program is entered at its 
standard entry point. The value count specifies how many breakpoints 
are to be ignored before stopping. Arguments to the subprocess may be 
supplied on the same line as the conunand. An argiunent starting with 
< or > causes the standard input or output to be established for the 
command. All signals are turned on on entry to the subprocess. 

:e Setup a subprocess as in :r; no instructions are executed. 

•.cs The subprocess is continued with signal s (see signal{2)). If address is 

given then the subprocess is continued at this address. If no signal is 
specified then the signal that caused the subprocess to stop is sent. 
Breakpoint skipping is the same as for :r. 

:8s As for c except that the subprocess is single stepped count times. If 

there is no current subprocess then objfil is nm as a subprocess as for :r. 
In this case no signal can be sent; the remainder of the line is treated as 
argmnents to the subprocess. 

:S5 As for :c except that a temporary breakpoint is set at the next instruc- 

tion. Useful for stepping across subroutines. 

:x a [b]... Execute subroutine a with parameters [bj... 

:k The current subprocess, if any, is terminated. 

Variables 

Adb provides a number of variables. Named variables are set initially by adb but are not used 
subsequently. Nmnbered variables are reserved for communication as follows. 

The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

9 The coimt on the last $< command. 

On entry the following are set from the system header in the corfil. If corfil does not appear to 
be a core file, then these values are set from objfil. 

b The base address of the data segment. 

d The data segment size. 

e The entry point. 

m The "magic" niunber as defined in magic.h. 

a The stack segment size. 

t The text segment size. 

Addresses 

The address in a file associated with a written address is determined by a mapping associated 
with that file, see $m. Each mapping is represented by two triples {bl, el, fl) and {b8, eS, fS). 

The file address corresponding to a written address is calculated as follows: 
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bl < address < el => file address = address + fl-bl., 

otherwise, 

b8 < address < e2 => file address = address + f8-b8, 

otherwise, the requested address is not legal. In some cases (e.g., for programs with separated I 
and D space) the two segments for a file may overlap. If a ? or / is followed by an * then only 
the second triple is used. 

The initial setting of both mappings is suitable for normal a.out and core files. If either file is 
not of the kind expected then, for that file, bl is set to 0, el is set to the maximum file size and fl 
is set to 0; in this way the whole file can be examined with no address translation. 

In order for adb to be used on large files all appropriate values are kept as signed 32-bit integers. 

RETURNS 

Adb comments about inaccessible files, syntax errors, abnormal termination of commands, etc. It 
echoes "adb" when there is no current command or format. Exit status is 0, unless last command 
fouled or retm^ed non-zero status. 

HARDWARE DEPENDENCIES 

Series 200, 300 

The -I option is not currently supported. 

The I format prints machine instructions, like i, except that immediate constants are 
printed in decimal. 

The command $n is provided to set the number of significant digits for floating point diunps 
to address. 

Variable 9 is not updated for the $< command, and the $<< command is not supported. 

Series 800 

The $f command will print floating point registers as 32-bit single precision and $F will 
print these registers as 64-bit doubles. 

$R will print all registers available to adb users. 

The :x and :S commands are not currently supported. 

A -k option is provided that allows virtual-to-physical translations, which is useful for ker- 
nel debugging. In this case, core should be an HP-UX crash dmnp or /dev/mem. 

When adb is invoked with this option, it sets up the context of the currently running process 
using space registers foiu- through seven. A user specified address is dereferenced by com- 
bining it with the appropriate space register depending on which quadrant the 32 bit 
address lies. The $p command is provided to change the current context. The address 
argument is the address of the corresponding process structure. 

When the current radix is not (decimal) ten, the -k option allows adb to support the notion 
of long pointers or addresses in the form <space> .<off'8et>. Once a space is specified, all 
subsequent addresses are dereferenced using that space imtil another long address is entered. 
If a space equal to (hexadecimal) OxffflFifff is used, the previous context is back in effect and 
adb reverts to using space registers four through seven to dereference 32 bit addresses. 

AUTHOR 

Adb was developed by AT&T and HP. 

FILES 

a.out 

core 

/dev/mem 
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/dev/swap 

SEE ALSO 

ptrace(2), a.out(4), core(4). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

adjust - simple text formatter 

SYNOPSIS 

a4}u8t [ -bcjr ] [ -m column ] [ -t tabsize ] [ files... ] 

DESCRIPTION 

This command is a simple text formatter for filling, centering, left and right justifying, or right- 
justifying text paragraphs, designed for interactive use. It reads the concatenation of input files 
(or standard input if none are given) and produces on standard output a formatted version of its 
input, with each paragraph formatted separately. If "-" is given as an input filename, adjust 
reads standard input at that point. (You can use "— " as an argument to separate "-" from 
options.) 

Adjust reads text from input lines as a series of words separated by blanks, tabs, or newlines. 
Text lines £ire grouped into paragraphs separated by blank lines. By default, text is carried over 
to the output subject only to simple filling (see below), with a right margin of 72, and leading 
blanks converted to tabs where possible. 

Options are: 

-b Do not convert leading blanks to tabs on output. Thus there are no tabs in the output. 

-c Center text on each line. Lines are pre- and post-processed, but no filling is done. 

-j Justify text. After filling, insert blanks in each line, except the last line of each para- 

graph, as needed to right-justify it, while keeping the justified left margin. 

-r After filling text, adjust the indentation of each line for a smooth right margin (ragged 

left margin). 

—mcolumn 

Set the right fill margin to the given column nimiber, instead of 72. Text is filled, and 
optionally right justified, so that no output line extends beyond this column (if possible). 
If -mO is given, the current right margin of the first line of each paragraph is used for 
that and all subsequent lines in the paragraph. 

By default, text is centered on column 40. With -c, the -m option sets the middle 
column of the centering "window", but -mO auto-sets the right side as before (which then 
determines the center of the "window"). 

—ttabsize 

Set the tab size to other than the default (eight colmnns). 

Only one of the -c, -j, and -r options is allowed at once. 

Details 

Before doing anything else to a line of input text, adjust first handles beickspaces, rubbing out 
preceding characters in the usual way. Next it ignores all non-printable characters except tab. 
Then it expands all tabs to blanks. 

For simple text filling, the first word of the first line of each paragraph is indented the same 
amoimt as in the input line. Each word is then carried to the output followed by one blank. 
"Words" ending in <terminal>[<quote>][<close>] are followed by two blanks, where <terminal> 
is any of ".:?!", <quote> is a single or double quote, and <close> is £Uiy of ")]}", e.g.: 

end. of? sentence.' sorts!" of.) words?"] 

The program starts a new output line whenever adding a word (other than the first one) to the 
current line would pass the right margin. 
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Adjtist understands indented first lines of paragraphs (like this one) when filling. The second 
and subsequent lines of each paragraph are indented the same amoimt as the second line of the 
paragraph in the input, if there is a second line, else the same as the first line. 

* Adjtist has a rudimentary understanding of tagged paragraphs (like this one) 

when filling. If the second line of a paragraph is indented more than the first, 
and the first line has a word beginning at the same indentation as the second 
line, the column positions of the tag words (prior to that one) are 'frozen' (not 
altered). 

Tag words are passed through without change of colmnn position, even if they extend beyond the 
right margin. The rest of the Ime is filled or right-justified from the position of the first non-tag 
word. 

When -j is given, adjtist uses an intelligent algorithm to insert blanks in output lines where they 
are most needed, until the lines extend to the right margin. First, all one-blank word separators 
are examined. One blank is added first to those separators with the most total letters in the 
words on both sides. If all one-blank separators are increased to two blanks, and more blanks 
must be inserted, it repeats the algorithm, this time with two-blank separators, and so on. 

Output line indentation is held to one less than the right margin. If a single word is larger than 
the line size (right margin minus indentation), that word appears on a line by itself, properly 
indented, and extends beyond the right margin. However, if -r is used, such words are still 
right-justified, if possible. 

DIAGNOSTICS 

Adjust complains to standard error and later retiu-ns a non-zero value if any input file cannot be 
opened (it skips the file). It does the same (but quits immediately) if the argument of -m or -t is 
out of range, or if the program is improperly invoked. 

Input lines longer than BUFSIZ are silently split (before tab expansion) or truncated (afterwards). 
Lines too wide to center begin in column 1 (no leading blanks). 

WARNINGS 

This program is designed to be simple and fast. It does not recognize backslash to escape white 
space or anything else. It does not recognize tagged paragraphs where the tag is on a line by 
itself. It knows that lines end in newline or null, and how to deal with tabs and backspaces, but 
it does not do einything special with other characters like form feed (they are just ignored). For 
complex operations, the standard text processors are likely to be more appropriate. 

This program could be implemented instead as a set of independent programs, fill, center, and jus- 
tify (with -r option). However, this would be much less efficient in actual use, especially given 
the program's special knowledge of tagged paragraphs and last lines of paragraphs. 

These options were considered but not added, because the creeping featurism had to stop some- 
where, before this program became another nroff{l): 

-h Hyphenate. Allows the program to break and join words at existing hyphens 

(only). Words are broken across lines, at single hyphens smrounded by non- 
whitespace characters. Likewise, a word ending in a single hyphen, followed by 
whitespace, followed by a non-hyphen character, is joined to the next word 
without whitespace if needed. 

-n NofiU. Only allowed with -j or -r, it inhibits filling, i.e. words are not moved 

fi-om one line to another. Thus existing text can be left/right or right justified 
without being otherwise modified. (Note that -n is always in effect for — c, 
centering.) 

EXAMPLES 

This command is useful for filtering text while in ui'(l). For example. 
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!}adjust 
reformats the rest of the current paragraph (from the current line down), evening the lines. 
You can give the vl command: 

:map *X {!}adju8t -j'V'M 

(where "*" denotes control characters) to set up a useful "finger macro". Then typing "X will 
reformat the entire current paragraph. 

Note that adjust -ml is a simple way to break text into separate words, without white space, 
except for tagged paragraphs tags. 

AUTHOR 

Adjust was developed by HP. 

SEE ALSO 

nroflF(l). 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

admin - create and administer SCCS files 

SYNOPSIS 

admin [-n] [-i[name]] [-rrel] [-t[name]] [-fflag[flag-val]] [-dflag[flag-val]] [-alogin] [-elogin] 
[-m[mrlist]] [-y[conmient]] [-h] [-z] files 

DESCRIPTION 

Admin is used to create new SCCS files and change parameters of existing ones. Arguments to 
admin, which may appear in any order, consist of keyletter arguments, which begin with -, and 
named files (note that SCCS file names must begin with the characters s.). If a named file does 
not exist, it is created, and its parameters are initialized according to the specified keyletter argu- 
ments. Parameters not initialized by a keyletter sirgmnent are assigned a default value. If a 
named file does exist, parameters corresponding to specified keyletter arguments are changed, and 
other parameters are left as is. 

If a directory is named, admin behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name does not begin with s.) 
and imreadable files are silently ignored. If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be processed. Again, non- 
SCCS files and unreadable files £ire silently ignored. 

The keyletter arguments are as follows. Each is explained as though only one named file is to be 
processed since the effects of the arguments apply independently to each named file. 

-n This keyletter indicates that a new SCCS file is to be created. 

-ifname] The name of a file from which the text for a new SCCS file is to be taken. The text 

constitutes the first delta of the file (see -r keyletter for delta nmnbering scheme). 
If the i keyletter is used, but the file name is omitted, the text is obtained by read- 
ing the standard input until an end-of-file is encoimtered. If this keyletter is omit- 
ted, then the SCCS file is created with an empty initial delta. Only one SCCS file 
may be created by an admin command on which the i keyletter is supplied. Using 
a single admin to create two or more SCCS files requires that they be created 
empty (no -i keyletter). Note that the -i keyletter implies the -n keyletter. 

-rrel The refease into which the initial delta is inserted. This keyletter may be used only 

if the -i keyletter is also used. If the -r keyletter is not used, the initial delta is 
inserted into release 1. The level of the initial delta is always 1 (by default initial 
deltas are named 1.1). 

-t[namej The name of a file from which descriptive text for the SCCS file is to be taken. If 

the -t keyletter is used £ind admin is creating a new SCCS file (the -n and/or -i 
key letters also used), the descriptive text file name must also be supplied. In the 
case of existing SCCS files: (1) a -t keyletter without a file name causes removal of 
descriptive text (if any) currently in the SCCS file, and (2) a -t keyletter with a file 
name causes text (if any) in the named file to replace the descriptive text (if any) 
currently in the SCCS file. 

-{flag This keyletter specifies a flag, and, possibly, a value for the flag, to be placed in the 

SCCS file. Several f keyletters may be supplied on a single admin command line. 
The allowable flags and their values are: 

b Allows use of the -b keyletter on a get{l) command to create branch del- 

tas. 

cceiV The highest release (i.e., "ceiling"), a number less than or equal to 9999, 
which may be retrieved by a get{l) command for editing. The default 
value for an imspecified c flag is 9999. 
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iflooT The lowest release (i.e., "floor"), a number greater than but less than 
9999, which may be retrieved by a get{l) command for editing. The 
default value for an xmspecified f flag is 1. 

dSID The default delta number (SID) to be used by a get{l) command. 

istr Causes the "No id keywords (cm7)" message issued by get{l) or delta{l) 

to be treated as a fatal error. In the absence of this flag, the message is 
only a warning. The message is issued if no SCCS identification keywords 
(see get{l)) are foimd in the text retrieved or stored in the SCCS file. If a 
value is supplied, the keywords must exactly match the given string, how- 
ever the string must contain a keyword, and no embedded newlines. 

j Allows concurrent get{l) commands for editing on the same SID of an 

SCCS file. This allows multiple concurrent updates to the same version of 
the SCCS file. 

Mist A list of releases to which deltas can no longer be made (get -e against 
one of these "locked" releases fails). The list has the following syntax: 
<list> ::= <range> I <list> , <range> 
<range> ::= RELEASE NUMBER I a 

The character a in the list is equivalent to specifying all releases for the 
named SCCS file. Omitting any list is equivalent to a. 

n Causes delta{l) to create a "null" delta in each of those releases (if any) 

being skipped when a delta is made in a new release (e.g., in making delta 
5.1 after delta 2.7, releases 3 and 4 are skipped). These null deltas serve 
as 'anchor points' so that branch deltas may later be created from them. 
The absence of this flag causes skipped releases to be non-existent in the 
SCCS file, preventing branch deltas from being created from them in the 
future. 

qtext User definable text substituted for all occurrences of the %Q% keyword in 
SCCS file text retrieved by get{l). 

mmod Module name of the SCCS file substituted for all occurrences of the %M% 
keyword in SCCS file text retrieved by get{l). If the m flag is not 
specified, the value assigned is the name of the SCCS file with the leading 
s. removed. 

ttype Type of module in the SCCS file substituted for all occurrences of %Y% 
keyword in SCCS file text retrieved by get{l). 

v[pgm] Causes delta{l) to prompt for Modification Request (MR) niunbers as the 
reason for creating a delta. The optional value specifies the name of an 
MR number validity checking program (see delta{l)). (If this flag is set 
when creating an SCCS file, the m keyletter must also be used even if its 
value is null). 

-dflag Causes removal (deletion) of the specified flag from an SCCS file. The -d keyletter 

may be specified only when processing existing SCCS files. Several -d keyletters 
may be supplied on a single admin command. See the -f keyletter for allowable 
flag names. 

Hist A list of releases to be "unlocked". See the -f keyletter for a description 
of the 1 flag and the syntax of a list. 

-alogin A login name, or numerical HP-UX group ID, to be added to the list of users which 

may make deltas (changes) to the SCCS file. A group ID is equivalent to specifying 
all login names common to that group ID. Several a keyletters may be used on a 
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single admin command line. As many logins, or numerical group IDs, as desired 
may be on the list simultaneously. If the list of users is empty, then anyone may 
add deltas. If login or group ID is preceded by a ! they are to be denied permission 
to make deltas. 

-elogin A login name, or nimierical group ID, to be erased from the list of users allowed to 

make deltas (changes) to the SCCS file. Specifying a group ID is equivalent to 
specifying all login names common to that group ID. Several e keyletters may be 
used on a single admin command line. 

—y [comment] The comment text is inserted into the SCCS file as a comment for the initial delta 
in a manner identical to that of delta{l). Omission of the -y keyletter results in a 
default comment line being inserted in the form: 

date and time created YY/MM/DD HH:MM:SS by login 

The -y keyletter is valid only if the -i and/or -n keyletters are specified (i.e., a 
new SCCS file is being created). 

-mfmrliatj The list of Modification Requests (MR) numbers is inserted into the SCCS file as 
the reason for creating the initial delta in a manner identical to delta{l). The v 
flag must be set and the MR numbers are validated if the v flag has a value (the 
name of an MR niunber validation program). Diagnostics will occiir if the v flag is 
not set or MR validation fails. 

-h Causes admin to check the structure of the SCCS file (see acc3file{4)), and to com- 

pare a newly computed check-simi (the siun of all the characters in the SCCS file 
except those in the first line) with the check-sum that is stored in the first line of 
the SCCS file. Appropriate error diagnostics are produced. 

This keyletter inhibits writing on the file, so that it nullifies the effect of any other 
keyletters supplied, and is, therefore, only meaningful when processing existing files. 

-z The SCCS file check-sxun is recomputed and stored in the first line of the SCCS file 

(see -h, above). 



FILES 



Note that use of this keyletter on a truly corrupted file may prevent future detection of the 
corruption. 

The last component of all SCCS file names must be of the form a.file-name. New SCCS files are 
given mode 444 (see chmod{l)). Write permission in the pertinent directory is, of coiu-se, required 
to create a file. All writing done by admin is to a temporary x-file, called jc.file-name, (see 
get{l)), created with mode 444 if the admin command is creating a new SCCS file, or with the 
same mode as the SCCS file if it exists. After successful execution of admin, the SCCS file is 
removed (if it exists), and the x-file is renamed with the name of the SCCS file. This ensures that 
changes are made to the SCCS file only if no errors occurred. 

It is recommended that directories containing SCCS files be mode 755 and that SCCS files them- 
selves be mode 444. The mode of the directories allows only the owner to modify SCCS files con- 
tained in the directories. The mode of the SCCS files prevents any modification at all except by 
SCCS commands. 

If it should be necessary to patch an SCCS file for any reason, the mode may be changed to 644 by 
the owner allowing use of ed{i). Care must be taken! The edited file should always be processed 
by an admin -h to check for corruption followed by an admin -a to generate a proper check- 
sum. Another admin -h is recommended to ensure the SCCS file is valid. 
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Admin also makes use of a transient lock file (called z. file-name), which is used to prevent simul- 
taneous updates to the SCCS file by different users. See get{l) for further information. 

SEE ALSO 

delta(l), ed(l), get(l), help(l), pr8(l), what(l), sccsfile(4). 

DIAGNOSTICS 

Use help{\.) for explanations. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

ar - archive and library maintainer for portable archives 

SYNOPSIS 

ar key [ posname ] afile [name] ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main use is to create and 
update library files as used by the link editor. It can be used, though, for any similar purpose. 
The magic string and the file headers used by ar consist of printable ASCII characters. If an 
archive is composed of printable files, the entire archive is printable. 

Individual files are inserted without conversion into the archive file. When ar creates an archive, 
it creates headers in a format that is portable across all machines. The portable archive format 
and structiu-e is described in detail in or (4). The archive symbol table (described in or (4)) is used 
by the link editor (/d(l)) to effect multiple passes over libraries of object files in an efficient 
manner. An sirchive symbol table is only created and maintained by ar when there is at least one 
object file in the archive. The archive symbol table is in a specially named file which is always the 
first file in the archive. This file is never mentioned or accessible to the user. Whenever the ar(l) 
command is used to create or update the contents of such an archive, the symbol table is rebuilt. 
The 8 option described below will force the symbol table to be rebuilt. 

Key must be present, and is an optional -, followed by one character fi-om the set drqtpmx, 
optionally concatenated with one or more of vuaibcls. Ajilt is the archive file. The namta are 
constituent files in the archive file. The meanings of the kty characters for operations on an 
archive are: 

d Delete the nsimed files from the archive file. 

r Replace the named files, or add a new file to the archive. If the optional charac- 

ter u is used with r, then only those files with dates of modification later than 
the archive files are replaced. If an optional positioning character from the set 
abi is used, the posname argmnent must be present and specifies that new files 
are to be placed after (a) or before (b or i) posname. In the absence of a posi- 
tioning character, new files are placed at the end. Ar will create afile if it does 
not already exist. If there are no file names, ar will create an empty archive file 
whose only contents is the archive header (see or(4)). 

q Quickly append the named files to the end of the archive file. Optional position- 

ing characters are invalid. The command does not check whether the added 
members are silready in the archive. This is useful only to avoid quadratic 
behavior when creating a large archive piece-by-piece. Ar will create afile if it 
does not eilready exist. 

t Print a table of contents of the archive file. If no names are given, all files in the 

archive are described. If names are given, information about only those files 
appears. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is 

present, then the posname argument must be present and, as in r, specifies 
where the files are to be moved. Note that, when used with a positioning charac- 
ter, the files are moved in the same order that they currently appear in the 
archive, not in the order specified on the command line. See EXAMPLES. 

X Extract the named files. If no names are given, all files in the archive are 

extracted. In neither case does x alter (i.e. delete entries from) the archive file. 
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The meanings of the remaining optional modifying characters are: 

8 Force the regeneration of the archive symbol table even if or(l) is not invoked 

with a command which will modify the archive contents. This command is use- 
ful to restore the archive symbol table after the strip{l) command has been used 
on the archive. 

V Verbose. Give a verbose file-by-file description of the making of a new archive 

file from the old archive and the constituent files. When used with t, it gives a 
long listing of all information about the files. When used with the d, m, p, q, 
and X options, the verbose option causes ar to print the key letter and file name 
associated with each file for that operation. For the r operation, ar will show an 
"a" if it added a new file, or an "r" if it replaced an existing one. 

c Create. Normally ar will create afile when it needs to (for the r and q opera- 

tions). The create option suppresses the normal message that is produced when 
afile is created. 

I Local. Place temporary files in the local current working directory, rather than 

in the directory specified by the environment variable TMPDIR or in the default 
directory /tmp. Only the d, m, r and s options use temporary files. 

Only the following combinations are meaningful: 

d: V, 1, 

r: u, v, c, 1, and a I b I i 

q: V, c, 

t: V, 8 

p: V, 8 

m: v, 1, and a I b I 1 

x: V, 8 

For other combinations of modifiers with operations not shown in the above table, the modifier 
has no effect. 

EXAMPLES 

The command: 

ar r newlib.a f3 f2 fl f4 

will create a new file (if one does not already exist) in archive format with its constituents entered 
in the order shown in the above command line. 

If you want to replace files f2 and f3 such that the new copies follow file fl and f3 follows f2, the 
commands: 

ar ma fL nevs^lib.a f2 f3 
ar ma fZ newlib.a f3 
ar r newlib.a f2 f3 

will produce the desired effect. The archive will now be ordered: 

newlib.a: fl f2' f3' f4 

where the single quote marks indicate updated files. The first command says "move f2 and f3 
after fl in newlib.a", thus creating the order: 

f 1 f3 fZ f4 

Note that the relative order of f2 and f3 has not changed. The second command says "move f2 
after f3 in newlib.a", creating the order: 

f 1 f2 f3 f4 
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The third command then replaces the files f2 and f3. Since the files f2 and f3 both ahready existed 
in the archive, this sequence of commands could not be simply replaced by: 

ar ra fl newlib.a f2 f3 

because the previous position and relative order of f2 and f3 in the archive will be preserved (no 
matter how the files are specified on the command line), producing the following archive: 

newlib.a: f3' f2' fl f4 

FILES 

/tmp/ar* temporaries 

SEE ALSO 

ld(l), lorder(l), strip(l), tmpnam(3S), a.out(4), ar(4). 

VARIABLES 

TMPDIR Where temporary files are kept. 

WARNING 

If you are the super-user, or will alter any archive file, even if it is write-protected. 

BUGS 

If the same file is mentioned twice in an argument list, it can be put in the archive twice. 

Ar reports cannot create file.a, where file.a is an ar-format archive file, even if file.a already 
exists. This message is triggered when JfUe.a is write-protected or inaccessible. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

arcv - convert archives to new format 

SYNOPSIS 

arcv file ... 

DESCRIPTION 

Arcv converts archive files (see or(l), and or(5)) from a pre-HP-UX 5.0 format to the HP-UX 5.0 
portable archive format. The conversion is done in place, and the command refuses to alter a file 
not in old archive format. 

Old archives are marked with a magic number of 0177545 at the start; new archives have a first 
line "!<arch>". 

FILES 



/tmp/arc* 

SEE ALSO 

ar(l), ar(5). 
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NAME 

as - assembler 

SYNOPSIS 

as [ -A ] [ -a afile ] [ -o objfile ] ( file ] 

REMARKS 

This is a generic page for a machine-dependent assembler. A specific page will be provided for 
each assembler. Not all HP-UX systems provide an assembler. 

DESCRIPTION 

As assembles the named file, or the standard input if no file name is specified. The optional argu- 
ments -A or -a may be used to obtain an assembly listing with offsets and instruction codes. If 
-A is used the listing goes to standard output. If -a is used the listing goes to afile. 

All undefined symbols in the assembly are treated as global. 

The output of the assembly is left on the file objfile; if that is omitted, .s is stripped from the end 
of the file name (if there) and .0 is appended to it. This becomes the name of the output file. As 
does not invoke Id. 

FILES 

/usr/tmp/* temporary files 
file.o object file 

SEE ALSO 

adb(l), ld(l), nm(l), a.out(4). 

The assembler reference for each machine. 

DIAGNOSTICS 

If the name chosen for the output file is of the form *?.[c8], the assembler issues an appropriate 
complaint and quits. When syntactic or semantic errors occur, a single-line diagnostic is displayed 
on stderr together with the line number and the file name in which it occurred. 

INTERNATIONAL SUPPORT 

8- £md 16-bit data, 8-bit filenames. 
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NAME 

as - assembler for MC68000, MC68010, and MC68020 

SYNOPSIS 

as [-L] [-Nsn] [-m] [-d] [-w] [-o objfile] [file] 
aslO [-L] [-Nsn] [-m] [-d] [-w] [-o objfile] [file] 
as20 [-L] [-Nsn] j-m] [-d] [-w] (-o objfile] [file] 

Remarks: 

This version of as is implemented on Series 300 only. 

DESCRIPTION 

As assembles the named file (which usually has a .s suflBx as in my-^prog.s). If file is not 
specified or if - is given, standard input is used instead. As is linked to aslO or as20 at installa- 
tion time to match the system processor model. This link determines which of the two assemblers 
is the default for as. If aslO is invoked (separately or through as), MC68010 object code is pro- 
duced (compatible with both the MC68010 and MC68020). If, on the other hand, as20 is invoked, 
MC68020 object code is produced (some MC68020 processor instructions are not supported by the 
MC68010). 

All imdefined symbols in the assembly are treated as global. 

Options are as follows: 

-L Generates entries in the linker symbol table for loced as well as global symbols. Normally, 
only global and undefined symbols are entered into the table. This option is useful when 
using adb{l) to debug assembly language programs. 

-Nsn 

Changes the size of the user symbol table to accommodate up to n elements. Default is 4000 
entries. 

-m Processes the input file using the m^(l) macro preprocessor before assembling it. 

-d When used with as20 assembler, as20 generates short-displacement forms for MC68010- 
compatible syntaxes, including forward references. This option is ignored by aslO. 

-o Causes output object code to be placed in file objfile. If -o is not specified and the source 
file is read fi-om stdin, the object file is written to a. out. If -o is not specified and the 
source file is not stdin, the object file is written to a file whose name is created by removing 
the .s suffix (if present) from the basename of filename file, then adding a .o suffix to the 
base filename. The object .o file is placed in the current directory. 

-w Suppresses warning messages (errors are not suppressed). 



FILES 



/usr/tmp/* temporary files (can be changed by using TMPDIR. See <mpnam(3S)). 
file.o object file 



SEE ALSO 

adb(l), astm(l), atrans(l), ld(l), m4(l), nm(l), a.out(5). 

HP-UX Assembler Reference and ADB Tutorial for Series 200/300 Computers. 

DIAGNOSTICS 

If the name chosen for the output file is of the form *.c or *.8, the assembler issues an appropriate 
complaint and quits. When syntactic or semantic errors occiu", a single-line diagnostic is pro- 
duced, including the line number and file name in which it occiurred. 

RESTRICTIONS/CAVEATS 

Expressions cannot have more than one forward-referenced symbol, except for the special form 
<symbol>-<symbol>. 
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WARNINGS 

If the -m option is used, keywords for m^ cannot be used as symbols in the input file because mi 
cannot determine which are assembler symbols and which are real m4 macros. 

BUGS 

The displacement value for the movp instruction must be a first-pass absolute 16-bit value. 

NOTES 

Wherever possible, the assembler should be accessed through a compilation system interface pro- 
gram, such as cc(l). 

Both assemblers support the complete MC68000 instruction set. However, if you are writing code 
for an MC68000 processor, you must limit instructions and program structures to those supported 
by the microprocessor. Using instructions supported by MC68010 or MC68020 processors on an 
MC68000 will cause an illegal instruction trap during program execution, but may not produce an 
error during program assembly and loading. 
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NAME 

as - assembler (Precision Architecture) 

SYNOPSIS 

as [ [option] ... [file] ... ] ... 

DESCRIPTION 

As assembles the named file, or the standard input if no file name is specified. The optional argu- 
ment -1 may be used to obtain an assembly listing with offsets. 

The output of the assembly is left on the file objfile. If that is omitted, .s is stripped from the end 
of the file name (if there) and .o is appended to it. This becomes the name of the output file. 

The output of 03 is not optinoized. As creates relocatable object files which must be processed by 
Id to be made executable. 

Cc assembles .s files together with pcc—prefix.s and subsequently invokes Id. 

Options 

As recognizes the following options. 

-e An unlimited number of errors will be tolerated before the assembly process is 

abandoned. Normally, only a himdred errors are allowed. 

-f Procedures by default will be callers of other procedures. The normal default is 

that procedures do not call other procediu-es. 

-1 Listing to standard output is made of the program after assembly. This listing 

shows offsets of instructions and actual values for fields. 

-o outfile Produce an output object file by the name outfile instead of using the default .o 

suffix. 

-8 The output file will have suffix .ss and be of a format suitable for conversion to 

the ROM burning programs. 

-u Unwind descriptors will not be created. In order to avoid the need for .CAL- 

LINFO, it must also be the case that .ENTER and .LEAVE have not been used. 

-V xrfile Provides the name of a file to which cross reference data is written. 

DIAGNOSTICS 

When syntactic or semantic errors occur, a single-line diagnostic is displayed on stderr together 
with the line number and the file name in which it occiured. 

WARNINGS 

As does not do macro processing. 

Trailing operands (except for a pc relative branch displacement) may be omitted and default to 

zero. Trsiiling commas may also be omitted. Leading commas are ignored. 

FILES 

/lib/pcc_prefix.s space and register definitions 

/usr /include/hard reg.h hardware register equates 

/usr/include/soft_reg.h follows calling convention 

/usr/include/std space.h space and subspace declarations 

/lib/as^msgs.cat error message catalog 

file.o object file 

SEE ALSO 

cc(l), ld(l), adb(l), nm(l). 

Precision Architecture Assembler Technical Reference Manual. 
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NAME 

asa - interpret ASA carriage control charswiters 

SYNOPSIS 

asa [files] 
DESCRIPTION 

Asa interprets the output of FORTRAN programs that utilize ASA carriage control characters. It 

processes either the files whose names are given as arguments or the standard input if no file 

names are supplied. The first character of each line is assumed to be a control character. Their 

meanings are: 

(blank): single new line before printing 

0: double new line before printing 

1: new page before printing 

+: overprint previous line. 

Lines beginning with other than the above characters are treated as if they began with / /. The 

first character of a line is not printed. If any such lines appear, an appropriate diagnostic will 

appear on standeird error. This program forces the first line of each input file to start on a new 

page. 

To view correctly the output of FORTRAN programs which use ASA carriage control characters, 

aaa could be used as a filter thus: 

a.out I asa I Ip 

and the output, properly formatted and paginated, would be directed to the line printer. FOR- 
TRAN output sent to a file could be viewed by: 

asa file 
SEE ALSO 

efl(l), f77(l), fsplit(l), ratfor(l). 
INTERNATIONAL -SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

astm - translate assembly language 

SYNOPSIS 

astrn [ filename ] 

Remarks: 

Astrn is implemented on the Series 200/300 only. 

DESCRIPTION 

Astrn translates an assembly language source file from previous HP-UX Series 200/300 assem- 
bly language syntax to new Series 300 HP-UX assembly language syntax. If no filename is given, 
input is assumed to come from stdin. 

If an opcode is not recognized, a warning message is given and the entire line is passed through 
imchanged. For any syntax error detected such that translation cannot continue, astrn reports an 
error and translation terminates. 

Lines longer than 132 characters are truncated to 132 characters. 

For a line beginning with '*' (indicating a comment), the '*' is translated to a '#' but is preceded 
by a blank to allow preprocessing with cpp(l). 

Absolute displacements oflF the program coimter cannot be guaranteed to translate correctly. Any 
line referencing the program counter will be flagged by a warning message. 

Certain capabilities supported on the old assembler are not accepted by the new assembler. These 
include: 

The alias and include pseudo-ops are not supported. An error message is given and translation 
terminates. 

The new £issembler restricts expressions involving forward references for which astrn makes no 
check. Such references may involve only a single symbol, a symbol plus or minus an absolute 
expression, or the subtraction of two symbols. 

The characters '$', '@', '?', and '\177' are no longer accepted as valid identifier characters. These 
are translated to 'S', 'A', 'Q', and 'D' respectively and a warning is issued. 

Span-dependent branches jcc are translated to hcc.w. 

An identifier equated to a register name will be translated but the assembler will report an error. 

Local labels are translated to a concatenation of the nesu-est previous ordinary label and the local 
label itself. This includes changing the '$' to a 'S'. 

SEE ALSO 

as(l), atrans(l). 
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NAME 

at, batch - execute commands at a later time 

SYNOPSIS 

at time [ date ] [ + increment ] 
at -r job... 
at -1 [ job... ] 

batch 

DESCRIPTION 

At and batch read commands from standard input to be executed at a later time. At allows you 
to specify when the commands should be executed, while jobs queued with batch will execute 
when system load level permits. At -r removes jobs previously scheduled with at. The -1 option 
reports all jobs scheduled for the invoking user. 

Standard output and standard error output are msdled to the user unless they are redirected else- 
where. The shell environment variables, current directory, umask, and ulimit are retained when 
the commands are executed. Open file descriptors, traps, and priority are lost. 

Users are permitted to use at if their name appears in the file /u8r/lib/cron/at.allow. If that 
file does not exist, the file /usr/lib/cron/at.deny is checked to detennme if the user should be 
denied access to at. If neither file exists, only root is allowed to submit a job. If only at.deny 
exists and is empty, global usage is permitted. The allow/deny files consist of one user name per 
line. 

The time may be specified as 1, 2, or 4 digits. One and two digit numbers are taken to be ho\irs, 
four digits to be hoais and minutes. The time may alternately be specified as two numbers 
separated by a colon, meaning hour ■.minute. A sufiBx am or pm may be appended; otherwise a 
24-hoiu' clock time is understood. The suflBx zulu may be used to indicate GMT. The special 
names noon, midnight, now, and next are also recognized. 

An optional date may be specified as either a month name followed by a day number (and possi- 
bly year number preceded by an optional comma) or a day of the week (fully spelled or abbrevi- 
ated to three characters). Two special "days", today and tomorrow are recognized. If no date 
is given, today is assumed if the given hour is greater than the ciurent hour and tomorrow is 
assumed if it is less. If the given month is less than the current month (and no year is given), 
next year is assumed. 

The optional increment is simply a nvunber suffixed by one of the following: minutes, hours, 
days, weeks, months, or years. (The singular form is also accepted.) 

Thus legitimate commands include: 

at 0815am Jan 24 
at 8:15am Jan 24 
at now -f- 1 day 
at 5 pm Friday 

At and batch write the job number and schedule time to standard error. 

Batch submits a batch job. It is almost equivalent to "at now", but not quite. For one, it goes 
into a different queue. For another, "at now" will respond with the error message too late. 

At -r removes jobs previously scheduled by at or batch. The job number is the nmnber given to 
you previously by the at or batch command. You can also get job numbers by typing at -1. You 
can only remove your own jobs unless you are the super-user. 

EXAMPLES 

The at and batch commands read from standard input the commands to be executed at a later 
time. Sh{l) provides different ways of specifying standard input. Within your commands, it may 
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be useful to redirect standard output. 

This sequence can be used at a terminal: 
batch 

ntoS filename >outfile 
<control-D> (hold down 'control' and depress 'D') 

This sequence, which demonstrates redirecting standard error to a pipe, is useful in a shell pro- 
cedure (the sequence of output redirection specifications is significant): 

batch «! 

laoS filename 2>&1 >outfile I mail loginid 

! 

To have a job reschedule itself, invoke at from within the shell procedure, by including code simi- 
lar to the following within the shell file: 

echo "sh shellfile" I at 1900 thursday next week 

FILES 

/usr/lib/cron main cron directory 

/usr/lib/cron/at.allow list of allowed users 

/usr/lib/cron/at.deny list of denied users 

/usr/spool/cron/atjobs spool area 

/usr/lib/cron/queuedefs scheduling information 

SEE ALSO 

cron(lM), crontab(l), kiU(l), mail(l), nice(l), ps(l), sh(l). 

DIAGNOSTICS 

Complains about various syntax errors and times out of range. 

INTERNATIONAL SUPPORT 

at: 8- and 16-bit data, 8-bit filenames. 
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NAME 

aterm - general purpose asynchronous terminal emulation 

SYNOPSIS 

aterm configfile 

Native Language Support: 
8-bit data. 

Remarks: 

Aterm is implemented on the Series 500 only. 

DESCRIPTION 

Aterm is a general purpose asynchronous terminal emulator designed for maximum connection 
flexibility and simple file transfers without remote host support. Transparent pass-through mode 
provides all user terminal capabilities in multi-user systems. 

Configfile is used by aterm to match the particular terminal configuration needed for the remote 
system you are logging onto. This file consists of configuration commands, one to a line. Each 
line consists of the command name and its argmnents, if any. Only configuration parameters 
which differ from the standard default need be specified. Most configuration commands can also 
be given from the keyboard while the emulator is running. You can exit aterm by typing "".". 

The following list shows the recognized configuration command names: 

da Serial device file name (no default); 

hn Name of remote computer system (no default); 

db Number of data bits per character: 5, 6, 7, or 8 (default = 7); 

sb Nmnber of stop bits per character: 1, 1.5, or 2 (default = 1); 

pa Character parity: none (n), odd (o), even (e), zero (0), or one (1) (default = o); 

dr Rate for data sent and received: 50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 3600, 

4800, 9600, or 19200 baud (default = 2400 baud); 

mc Modem control: enabled (-I-) for full-duplex modem, or disabled (-) for full-duplex hard- 
wired connection (default = -); 

ss Switched service: auto-answer (a) or manual originate (o) (default = o); 

ga Gap: nmnber of character transmission times to delay between successive output charac- 

ters; values range from to 254 (default = 0); 

ec Echo: enabled (-I-) if the host computer echos characters sent by the emulator, disabled 

(-) otherwise (default = -); 

te Terminal ENQ/ACK: enabled (-I-) or disabled (-) (default = -I-); 

he Host ENQ/ACK: enabled (-I-) or disabled (-) (default = -); 

tx Termmal XON/XOFF: enabled (-I-) or disabled (-) (default = -); 

hx Host XON/XOFF: enabled (-I-) or disabled (-) (default = -); 

im Input mode: block (b), chsiracter (c), or line (1) (default = b); 

om Output mode: character (c) or line (1) (default = c); 

ph Prompt handshake: if enabled (-I-), the emulator waits for the prompt sequence before 
sending each line of data diuring an input diversion; if disabled (-), no wait is performed 
(default = -); 

pt Prompt timeout: nmnber of seconds to allow for receipt of a prompt sequence diu-ing an 

input diversion; values range from 1 to 600, with disabling the timeout altogether 
(default = 0); 

st Single text terminators: list of characters, any of which terminates a line sent by the host 

computer when the emulator is in input line mode; up to eight characters may be 
specified (default = no characters); 

dt Double text terminator: a pair of characters which together terminate a line sent by the 

host computer when the emulator is in input line mode (default = carriage-retimi/line- 
feed); 
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ps Prompt sequence: one or two characters which temunate a line sent by the host com- 

puter when the emulator is in input line mode, and which satisfy the prompt handshake if 
enabled (default = DCl); 

hi Beginning of line: character to be prefixed to each line sent to the host computer (default 

= none); 

el End of line: one or two characters to be postfixed to each line sent to the host computer 

(default = carriage-retmn); 

es Local command character: character which designates a local command to be interpreted 

by the emulator if it comes at the beginning of a line read from the standard input 
(default = ~). 

Note that emulation does not include block or format modes. 

SEE ALSO 

cu(lC) if simple connections are adequate or if you are calling another HP-UX system; 

uucp(lC) for file transfers with other HP-UX systems. 

HP-UX Network Communications Guide. 

BUGS 

Does not work with 6-channel multiplexer. 
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NAME 

atrans - translate assembly language 

SYNOPSIS 

atrans [ -n ] [ filename ] 

Remarks: 

Atrans is implemented on the Series 200/300 only. This page describes Series 300 HP-UX starting 
at Release 5.15. 

DESCRIPTION 

Atrans translates an assembly language source file from Series 200/300 Pascal workstation 
assembly language syntax to Series 300 HP-UX assembly language syntax. If no filename is 
given, input is assumed to come from stdin. 

If an opcode is not recognized, the entire line is passed through unchanged. For any syntax error 
detected such that a line cannot be translated, atrans issues an error message. 

Lines longer than 132 characters are truncated to 132 characters. 

Absolute displacements off the program counter cannot be guaranteed to translate correctly. Any 
line referencing the program counter will be flagged by a warning message. 

The HP-UX assembler restricts expressions involving forward references for which atrans makes 
no check. Such references may involve only a single symbol, a symbol plus or minus an absolute 
expression, or the subtraction of two symbols. 

The characters '$' and '@' are not accepted as valid identifier characters on the HP-UX assembler. 
These are translated to 'S' and 'A' respectively and a warning is issued. 

Lines containing the following list of Series 200/300 Pascal workstation pseudo-ops have no 
parallel in Series 300 HP-UX syntax and are translated as comment lines: decimal, end, lien, 
list, Iprint, nolist, noohj, nosyms, page, spc, sprint, ttl. 

Lines containing the mname, include, or src pseudo-ops are translated as comment lines, and a 
warning is printed stating these are not supported by the Series SOO HP-UX assembler. 

The pseudo-ops, def, refa, and refr, are translated as global. 

Certain pseudo-ops require manual intervention to translate. Each line containing these pseudo- 
ops will cause a message to be printed stating that an error will be generated by the Series 300 
HP-UX assembler. These pseudo-ops are: com, Imode, org, rorg, rmode, smode, start. 

When specifying certain addressing modes, the Pascal workstation assembler may allow operands 
to appear out of order, whereas the HP-UX assembler does not. Atrans does not rearrange these 
into proper order. 

The -n option ccmverts groups of blanks to tabs. 

SEE ALSO 

as(l), astm(l). 
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NA\fE 

awk - text pattern scanning and processing language 

SYNOPSIS 

awk [ -Fc ] [ prog ] [ parameters ] [ files ] 

DESCRIPTION 

Awk scans each input file for lines that match any of a set of patterns specified in prog. With 
each pattern in prog there can be an associated action that will be performed when a line of a file 
matches the pattern. The set of patterns may appear literally as prog, or in a file specified as -f 
file. The prog string should be enclosed in single quotes (') to protect it from the shell. 

Parameters, in the form x=... y=... etc., may be passed to awk. 

Files are read in order; if there are no files, the standard input is read. The file name — means the 
standard input. Each line is matched against the pattern portion of every pattern-action state- 
ment; the associated action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default can be changed by 
using FS; see below). The fields are denoted $1, $2, . . . ; $0 refers to the entire line. 

A pattern-action statement has the form: 

pattern { action } 

A missing action means print the line; a missing pattern always matches. An action is a sequence 
of statements. A statement can be one of the following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] . • . } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expre8sion ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, new-lines, or right braces. An empty expression-list 
stands for the whole line. Expressions take on string or nimieric values as appropriate, and are 
built using the operators +,-, *, /, %, and concatenation (indicated by a blank). The C opera- 
tors ++, — , -|-=, -=, *=, /=, and %= are also available in expressions. Variables may be 
scalars, array elements (denoted x[i]) or fields. Variables are initialized to the null string. Array 
subscripts may be any string, not necessarily numeric; this allows for a form of associative 
memory. String constants are quoted ("); single quotes ('fP) are not recognized. 

The print statement prints its argmnents on the standard output (or on a file if >expr is present), 
separated by the current output field sepeirator, and terminated by the output record separator. 
The prini/ statement formats its expression list according to the format (see printf {3S)). 

The built-in function length returns the length of its argument taken as a string, or of the whole 
line if no argument. There are also built-in functions exp, log, aqrt, and int. The last tnmcates 
its argument to an integer; substr{s, m, n) retiuns the n-character substring of s that begins at 
position m. The function sprintf{fmt, expr, expr, ...) formats the expressions according to the 
printf{3S) format given by fmt and returns the resulting string. 

Patterns are arbitrary Boolean combinations ( !, ||, ick, and parentheses) of regular expressions 
and relational expressions. Regular expressions must be surroimded by slashes and are as in 
egrep (see grep{l)). Isolated regular expressions in a pattern apply to the entire line. Regular 
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expressions may also occur in relational expressions. A pattern may consist of two patterns 
separated by a comma; in this case, the action is performed for all lines between an occurrence of 
the first pattern and the next occurrence of the second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is either (for contains) 
or ! (for does not contain). A conditional is an arithmetic expression, a relational expression, or 
a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control before the first input line is 
read and after the last. BEGIN must be the first pattern, END the last. 

A single character c may be used to separate the fields by starting the program with: 

BEGIN { FS = c } 

or by using the -Fc option. 

Other variable names with special meanings include NF, the nmnber of fields in the current 
record; NR, the ordinal number of the current record; FILENAME, the name of the cmrrent mput 
file; OFS, the output field separator (default blank); ORS, the output record separator (default 
new-line); and OFMT, the output format for nimibers (default %.6g). 

EXAMPLES 

Print lines longer than 72 characters: 

length > 72 
Print first two fields in opposite order: 

{ print $2, $1 } 

Add up first column, print sum and average: 

{ s += U } 
END { print "smn is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; — i) print $i } 
Print all lines between start/stop pairs: 

/start/, /stop/ 
Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 

Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n-|-+; } 
{ print } 
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command line: awk -f program n=-5 input 

SEE ALSO 

grep(l), lex(l), sed(l), malloc(3X). 

BUGS 

Input white space is not preserved on output if fields are involved. 

There are no explicit conversions between numbers £ind strings. To force an expression to be 
treated as a nimiber add to it; to force it to be treated as a string concatenate the null string 
("") to it. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

banner make posters in large letters 

SYNOPSIS 

banner strings 

DESCRIPTION 

Banner prints its arguments (each up to 10 characters long) in large letters on the standard out- 
put. 

Each argument is on a separate line. 

SEE ALSO 

echo(l). 
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NAME 

basename, dimame extract portions of path names 

SYNOPSIS 

basename string [ suffix ] 
dirname strr;.; 

DESCRIPTION 

Basename deletes any prefix ejiding in / and the suffix (if present in stnng) from string, and 
prints the result on the standard output. It is normally used inside command substitution marks 

(\./) wjthin shell procedurcs. 

Dirname delivers ail but the last level of the path name in string. If string does not contain a 
directory component, dirname returns ".", indicating the current working directory 

EXAMPLES 

The foilowing sheii script, mvoked with the argument /usr/src/cmd/cat.c, compiles the nam.ed 
file and moves the output to a file named cat in the current directurv. 

fc Si 

my a.')'?r 'ba^eTiaiiH: $1 .c 

Tlu i-iiiowi'iK t'xaaipie will sei the she'I variable JNAMK to /uRr/arc/cri'd 

i',ij':\i i-,,^iu\iiu.C.-< rr r an ij fo; yiiiceris. Both coirima-Kis retuni 1 when sn-i^n no artn;'flcrifs, 

SEE ALSO 

cxprjij.snii)^ 

INTERN A TION A i, S UPpi;>i{ T 

8-bit ti!ena;ii<;t,. 
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NAME 

basic - Technical BASIC interpreter 

SYNOPSIS 

basic [-t] 

Remarks: 

This conunand requires installation of optional Technical BASIC software (not included with the 
standard HP-UX operating system) before it can be used. 

DESCRIPTION 

This conunand invokes the HP-UX Technical BASIC interpreter which can be used to execute 
BASIC conunands or run BASIC programs. 

The BASIC SHELL command is used when you need to temporarily exit the BASIC environment 
and spawn a new Bourne shell, from which you can execute any niunber of HP-UX commands. To 
terminate the shell and return to BASIC, type CTRL-D. 

The following option is recognized: 

-t causes the BASIC interpreter to operate in non-line-oriented mode. (Using this option only 
makes sense when running BASIC on a line-oriented terminal, since all other consoles and 
terminals will automatically run in non-line-oriented mode. See "line-oriented terminal" in 
the Glossary of the HP-UX Technical BASIC Reference Manual if you are not srn-e whether 
or not yo\u: terminal is line-oriented.) 

There are two situations in which this mode is useful: 

1. When you are using BASIC program lines or commands that exceed the width of a sin- 
gle lirie on the terminal screen (usually 80 characters). Refer to the "Line Length" dis- 
cussion in the Introduction section of the HP-UX Technical BASIC Reference Manual 
for further information about entering lines longer than the width of the screen. 

2. When data-overrun errors occiu: during relatively high system use that are caused by a 
serial interface that has only a single-character buffer. Such interfaces lose occasional 
characters because they have insufficient buflFer character space. This type of error 
does not occur when using interfaces that are equipped with multiple-character buffers 
such as the Series 200/300 Datacomm Interface or Series 500 ASI card. 



FILES 



/usr /bin /basic the BASIC interpreter. 

/usr/bin/makebin^c a shell script used for creating C binaries (binaries are routines that 

are written in another language but which can be called from BASIC). 

/usr/lib/bcrtO. o used when creating C binaries. 

/usr/bin/makebin^p a shell script used for creating Pascal binaries. 

/usr/lib/bprtO. o a file that is used when creating Pascal binaries. 

/usr/bin/makebin—f a shell script used for creating FORTRAN binaries. 

/usr/lib/bfrtO.o a file that is used when creating FORTRAN binaries. 

/usr/lib/libb.a (Series 200/300 only) a library that is used instead of libc.a when 

creating binaries. 

/usr/lib/examples/basic/get^started/* 

demonstration programs that are discussed in the HP-UX Technical 
BASIC Getting Started manual. 
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Series 200, 300, and 500 Only 



SEE ALSO 

HP-UX Technical BASIC Getting Started Manual 
HP-UX Technical BASIC Programming Guide 
HP-UX Technical BASIC I/O Programing Guide 
HP-UX Technical BASIC Reference Manual 
HP- UX Technical BASIC Implementation Specifics 
HP-UX Technical BASIC Quick Reference 



BUGS 



Depending on system load, some characters may be missing from the start-up message {Basic 
ready 1.0) or termination message (Exiting Basic). This should not happen on single-user systems 
or on multi-user systems where only one person is ciurently using the system. 
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NAME 

be arbitrary •y)recis'iori[ arithrr;etir laag^age 

SYNOPSIS 

be [ '-« n -I : ! fiie ... ] 

Hi'- I ^ r-iitre prc<'p«'-( r f ( r 1" ri^->c« t^^at T^Jfi ^I'fs ( ' i' fr(\ 'c? uiiliinited precisicni 
♦ \ 

Hr > ""^i il>i ^ c I '^ 1 v(i ill 1 i!(- tl;e dc iiij- it to tit 

I ! I ^ 1 a -11 tr^ > u-<-c i' -^t 1 -^ I '< ,1't < ^ iS ;i side-enecT . ilie 



' 5 I t i' r 1 ( r I t , 7; 

» ( "i ft •^ 



Otber oprrands 

-1 • . i . < i' , ' . r-n % 1^ « • 1. -s 'I h ','i \ ' • 

* ^t /r -I.. .i,'^.j „v,t 5.., .„. o> 

{ ^ : ... ; S } 
li i R I S 



quit 
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define L i L ..,., L ,i ( 
a-ii > I , [, 

} 
Function? in f\i? I rii ilh librarv- 

S(x) Siiit; 

U-<) i-'? 

j(n,x) Besse! fiinrtioi) 

Ail fiiuction arg!i;ae:if-, are ;sa^si^i by value, 

Th'» value of a sUitiTiCiit that is an expression ih prmtiK] uiiless the main operator is aii a&sigi:- 
iiieiit. Nu 0{)tT.it.,r.r are dpliiied for strings, but the sii-iiig is 7jriistcd if it appears in a context 
where aji expression result would ';>e pnoted. Either semicolons or riew-iiiies may separate state 
liieiits. AsKigiirne:iT. to f^caie inti'.ienecs the uumbei of digits to be retained o:i arithmet.e opervx 
tions in the manner of dcil) Assignment--' to ibase or o6a*e set the input and outjiut number 
radix respective'y, agam xh defined by dc{i;.. 

Thf saline ]^•U^•l ;n;iy lie used :u iv; :irray, a function, and a snnpie variable sinnilt.ineoufiH . Al! 
Vdriabies aie gl;>L;;d :-) the program. "Auto" variai)ies are pushed down during funetion c.iliK. 
When usnig arrays as funrtiou arguments or defining them as aut>ni!itir varia'iies, en.\pty square 
brackets must foiiove the array naine. 

The % operator yeilds the remainder at riie current scale, not the mteger modulus. 1 b.us, at scale 
i, 7 % 3 IS .] (one tenth), not j This is because (at scale 1) 7 / 3 is ^'.3 with .1 as the 



renianuiei 
EXAMPLE 



for(i=l, 1=^=1: i+4-){ 
a -- a*x 



Ui returni-; 



define'^ a fnnct; ;n to compute ^iii approximate value of the exponential funtitiou an-l 

for(!=;l. i<-lU; i + -f ) e(i) 
jsrinta approximate values of the exponential function of the first ten integers. 

FILES 

/usr/bin/di: desk calculator proper 
/usr/iib/iibb matiieroatieal libran- 
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SEE ALSO 

bs(l), dc(l). 

BUGS 

There are currently no && (AND) or 1 1 (OR) comparisons. 

The for statement must have all three expressions. 

Quit is interpreted when read, not when executed. 

Sc's parser is not robust in the face of input errors. Some simple expression like 2+2 will tend to 

get it back into phase. 
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NAME 

bdiff - big diff 

SYNOPSIS 

bdiflF filel file2 [n] [-s] 

DESCRIPTION 

Bdiff is used in a manner analogous to diff{l) to find which lines must be changed in two files to 
bring them into agreement. Its purpose is to allow processing of files which are too large for diff. 
Bdiff ignores lines common to the beginning of both files, splits the remainder of each file into n- 
line segments, and invokes diff upon corresponding segments. The value of n is 3500 by default. 
If the optional third argument is given, and it is niuneric, it is used as the value for n. This is 
useful in those cases in which 3500-line segments are too large for diff, causing it to fail. If filel 
(fiie2) is -, the standard input is read. The optional -s (silent) argument specifies that no diag- 
nostics are to be printed by bdiff (note, however, that this does not suppress possible exclamations 
by diff. If both optional arguments are specified, they must appear in the order indicated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to account for the segment- 
ing of the files (that is, to make it look as if the files had been processed whole). Note that 
because of the segmenting of the files, bdiff does not necessarily find a smallest sufficient set of file 
differences. 

FILES 

/tmp/bd????? 

SEE ALSO 

difi'(l). 

DIAGNOSTICS 

Use help{l) for explanations. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

bfs - big file scanner 

SYNOPSIS 

bfs [ - j naiTie 

DESCRIPTION 

Bfs is (almost) like ea(l) except that it is read-only and processes much larger files. Files can be 
up to 1024K bytes (the maximum possible size) and 32K lines, with up to 512 characters, includ- 
ing new-lme, per line. Bfs is usually more efficient than ed for scaiming a file, since the file is not 
copied to a buffer. It is most useful for identifying sections of a large file where cspht(\) can be 
used to divide it into more manageable pieces for editing, 

Normally, the size of the file being scanned is printed, as is the size of any file written with the w 
command. The optional ~ suppresses printing of sizes Input is prompted with ♦ if P .and a car 
riage return are typed as in ed. Prompting can be tunied off again by inputting another P and 
carriage return. Note that messages are given in response to errors if prompting is turned on. 

All address expressions described under ed are supported. In addition, regular expressions may L>e 
surrounded with two symbols besides / and ?: > indicates downward search without wrap- 
around, and < indicates upward search without wrap-around. Since bfs uses a different regular 
expression-matching routine from ed. the regular expressions accepted are slightly wider hi scope 
(see regcmp(3X)). There is a slight difference in mark names: only the letters a through z may be 
used, and all 26 marks are remembered. 

The e, g, V, k, r», p, q, w. =, ! and null connnands operate a.s described uudtr ed. Cormuands 

such as , -i— 1-+-, -f ++=, -12, and -f-4p are accepted. Note that l.lOp and 1,10 will both 

print the first ten lines. The f command only prints the name of the file being scanned; thers; is 
no remembered file name. The w command is independent of output diversion, truncation, or 
crunching (see the xo. xt and xc comjiiand*. t)eif)v.'j The following additional commands are 
available. 

xf file Further commands are taken from the named filt. VViien an end-of-file is 

reached, an interrupt signal is received or an error occurs, reading resumes vv'ith 
the file containing the xf. Xf commands may be nested to a deyjth of JO. 

xo [file] Further output from the p and uuil commands is diverted to the nsuned file. 
which, if necessary, is created mode 666. If file is missing, output is diverted to 

th<' star: ':irfi outj>:i*. Nf.tp x'-\<J oarh diversion- causes tnincatiop or creation ;.f 
the file. 

: label This positions a label in a command file. The label is terminated by new-line, 

and blanks between the : and the start of the label are ignored This command 
may also l>e used to insert conunents into a command file, since labels need not 
l)e referenced 

; . . . ixb/regular fjpTr^stun/ I.l'x I 

A jump (either upward or downward) is made to label if the command succeed.^. 
It fails under any of the following conditions: 

1. Either address is not between 1 and $. 

2. The second address is less than the first 

3. The regular expression does not match at least one line in the specified 
range, including the first and last lines. 

On success, . is set to the line matched and a jump is made to label. This com- 
mand is the only one that doesn't issue an error message on bad addresses, so it 
may be used to test whether addresses are bad before other commands are exe- 
cuted. Note that the command 
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xt number 



is an unconditional jump. 

1 lie xb command is allowed only if it is read from someplace other than a termi- 

iial. If it is read from a pipe only a downward jump is possible. 

List the marks currently in use (marks are set by the k rom.mand) 

Output from the p and null commands is truncated to at most number charac- 
ters. The initial nmnber is 255. 

XV [digit] \ spaces] [value] 

The variable name is the specified digit following the xv. xvSlOO or xv5 100 
both assign the value 100 to the variable 5. Xv61,100p assigns the value 
l,100p to the variable 6. To reference a variable, put a % in front of the vari- 
able name. For example, using the above assignments for variables 5 and 6: 

I Si J 

will all pnnt the first 100 lines. 

g/^5/p 

would globally search for the characters 100 and prmt each hne containing a 
Ttiatrh. To escape the special meaning of %, a \ must precede it. 

g/".*yii\cds]/p 

could be used to match and list lines containing prirdf of characters, decimal 
integers, or strings, 

Aiiirther feature of the xv command is that the first line of output from an HP- 
UX ccmrnand can he stored into a v;iriable. The only requirement is that the 
first character of value be an !. For example: 

xv5!cat jujsk 
Irm junk 
!echo "%5" 
xv6!expr %6 -f 1 

would put the current line into variable 5, print it, and increment the variable 6 
l)y one. To escape the special meaning of ! as the first character of value, pre- 
cede it with a \. 

xv7\'date 

stores the value !date into variable 7. 

xbz label 

xbn label These two commands will test the last saved return code from the execution of 
an HP-UX svstem command (I command) for a zero or nonzero value, respec- 
tively, and cause a branch to the specified label. The two examples below both 
search for the next five lines containing the string size. 

First example: 
xv55 
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:1 

/size/ 

xv5!expr %5 - 1 

!if [ %5 != ] ; then exit 2 ; fi 

xbn 1 

Second Example: 

xv45 

:1 

/size/ 

xv4!expr %4 - 1 

!if [ %4 = ] ; then exit 2 ; fi 

xbz 1 

xc [switch] 

If switch is 1, output from the p and null commands is cnmched; if stvitch is it 
isn't. Without an argument, xc reverses switch. Initially switch is set for no 
crunching. Crunched output has strings of tabs and blanks reduced to one blank 
and blank lines suppressed. 

DIAGNOSTICS 

? for errors in commands, if prompting is turned off. Self-explanatory error messages when 
prompting is on. 

SEE ALSO 

csplit(l), ed(l), regcmp(3X). 

INTERNATIONAL SUPPORT 

8-bit data £md filenames. 
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NAME 

bifchmod - change mode of a BIF file 

SYNOPSIS 

bifchmod mode device:file ... 

DESCRIPTION 

Bifchmod \s intended to mimic chmod{l). 

A BIF file name is recognized by the embedded colon (:) delimiter (see 61/(4) for BIF file naming 
conventions). 

The permissions of each named file £ire changed according to mode, which may be absolute or 
symbolic. An absolute mode is an octal number constructed from the OR of the following modes: 

4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod{2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (sesirch) by others. 

A symbolic mode has the form: 

[ who ] op permission [ op permission ] 

The who part is a combination of the letters u (for user's permissions), g (group) and o (other). 
The letter a stands for ugo, which is the default if who is omitted. 

Op can be + to add permission to the file's mode, - to t£ike away permission, or = to assign per- 
mission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or 
group ID) and t (save text - sticky); u, g or o indicate that permission is to be taken from the 
current mode. Omitting permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by conmias may be given. Operations are performed in the 
order specified. The letter s is only useful with u or g; t only works with u. 

EXAMPLES 

The first example denies write permission to others, and the second makes a file executable (using 
symbohc mode): 

bifchmod o-w file 

bifchmod +x file 

The next example below assigns read and execute permission to everybody, and sets the set-user- 
id bit. The second assigns read and write permission to the file owner, and read permission to 
everybody else (using absolute mode): 

bifchmod 4555 file 

bifchmod 644 file 

The following two extmiples perform the same fimction, namely to give read, write, and execute 
permission to the owner and read and execute permissions to everybody else for the BIF file 
/etc/script on /dev/rdslc/lsO: 

bifchmod a=rx,u-|-w /dev/rdsk/lsOi/etc/script 

bifchmod 755 /dev/rdsk/lsOi/etc/script 
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AUTHOR 

Bifchmod was developed by HP. 

SEE ALSO 

bif(4), chmod(l), chmod(2). 
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NAME 

bifchown, bifchgrp - change file owner or group 

SYNOPSIS 

bifchown owner device:file ... 
bifchgrp group device:file ... 

DESCRIPTION 

Bifchown and bifchgrp are intended to mimic chown{l) and chgrp(l). 

A BIF file name is recognized by the embedded colon (.) delimiter (see 6i/(4) for BIF file naming 
conventions) . 

Bifchown changes the owner of the files to owner. Owner may be either a decimal user ID or a 
login name found in the password file. 

Bifchgrp changes the group ID of the files to group. Group may be either a decimal group ID or a 
group name found in the group file. 

EXAMPLES 

The examples that follow assume that a BIF directory structure exists on the HP-UX device file 
/dev/rdsk/lsO. 

The first example sets the owner of the BIF file /users/abc/phone.num to adm: 

bifchown adm /dev/rdsk/lsO:/users/abc/phone.num 
The second example sets the group ID of the BIF file /tmp/b.date to the decimal number 105: 

bifchgrp 105 /dev/rdsk/lsO:/tmp/b.date 

AUTHOR 

Bifchown was developed by HP. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

bif(4), chown(l), group(4), passwd(4). 
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NAME 

bifcp - copy to or from BIF files 

SYNOPSIS 

bifcp filel file2 

bifcp filel [file2...] directory 

DESCRIPTION 

Bifcp is intended to mimic cp(l). 

A BIF file name is recognized by the embedded colon (:) delimiter (see 6i/(4) for BIF file naming 
conventions). 

Bifcp copies a BIF or HP-UX file to a BIF or HP-UX file, or list of files (HP-UX or BIF) to a 
directory. The last name on the argmnent list is the destination file or directory. 

The file name '-' (dash) is interpreted to mean standard input or standard output, depending on 
its position in the argmnent list. 

RETURNS 

Bifcp returns exit code if the file is copied successfully. Otherwise it prints a diagnostic and 
returns non-zero. 

EXAMPLES 

Copy the HP-UX file abc to the BIF file x/y/z within HP-UX device /dev/rdsk/lsO: 

bifcp abc /dev/rdsk/lsOix/y/z 

Copy BIF file /backup/log within /dev/rdsk/lsO to HP-UX file logcopy within the current 
directory: 

bifcp /dev/rdsk/lsOt/backup/log logcopy 

Copy BIF file archive within HP-UX device /dev/dsk/2s5 to standard output: 

bifcp /dev/dsk/285:arcliive - 
The following example copies the BIF files /a, /b, and /c to the HP-UX directory /users/dave: 

sdfcp /dev/rdsk/2s3:/a /dev/rd8k/283:/b /dev/rd8k/283:/c /users/dave 

The last example shows how you can implement a cat{l) program for concatenating BIF files 
using bifcp in a shell script: 

if [ $# -It 1 ] 
then 

echo "Usage: bifcat file ..." 

exit 1 
fi 

for i in $* 
do 

bifcp $1 - 
done 

WARNINGS 

Note that the media should NOT be mounted before using bifcp. 

The '-' (stdio) notation does not work in some situations. 

AUTHOR 

Bifcp was developed by HP. 

SEE ALSO 

bif(4), cp(l). 
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NAME 

biffind - find files in a BIF system 

SYNOPSIS 

biffind path-name-list expression 

DESCRIPTION 

Biffind is intended to mimic find{l). 

A BIF file name is recognized by the embedded colon (:) delimiter (see bif{4) for BIF file naming 
conventions). 

Biffind recursively descends the directory hierarchy for each path name in the path-name-list (i.e., 
one or more path names) seeking files that match a boolean expression written in the primaries 
given below. 



-name pattern 



-perm onum 



-type c 

-links n 
-user uname 

-group gname 

-size n 
-exec cmd 

-ok cmd 
-print 



True if pattern matches the current file name. Pattern may consist of ASCII 
characters as well as the meta characters: 

'*' match all characters 

'?' match any character 

[...] match a range of cheiracters. 

True if the file permission flags exactly match the octal nvunber onum, see 
chmod{l). If onum is prefixed by a minus sign, more flag bits (017777, see 
stat{2)) become significant and the flags are compared: 

(flags&onum) ==onum 

True if the type of the file is c, where c is b, c, d, p, or f for block special file, 
character special file, directory, fifo (a.k.a named pipe), or plain file. 

True if the file has n links. 

True if the file belongs to the user uname . If uname is numeric and does not 
appear as a login name in the /etc/passwd file, it is taken as a user ID. 

True if the file belongs to the group gname. If gname is mmieric £ind does not 
appear in the /etc/group file, it is taken as a group ID. 

True if the file is n blocks long. 

True if the executed cmd returns a zero value as exit status. The end of cmd 
must be pimctuated by an escaped semicolon "\;". A command argument {} is 
replaced by the cm-rent path name. 

Like -exec except that the generated command line is printed with a question 
mark first, and is executed only if the user responds by typing y. 

Always true; causes the current path name to be printed. This option must be 
included on the find command line anytime you want find to print the path 
names it has found on the standard output. If -print is not specified, find 
locates the files, but fails to tell you about them! 

When -print is specified as the only expression, find prints the absolute path 
names of all files it finds, beginning at each directory in the path-name-list. If 
—print is included as the last component of an expression, find prints the abso- 
lute path names of only those files that satisfy the other primaries in the expres- 
sion. 

True if the file has inode number n. 
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EXAMPLES 

To print the names of all files on the BIF volume /dev/rdsk/280: 

biffind /dev/rdsk/2sO: -print 

The following command finds all files in /dev/dsk/lsSi/usr/iib that are directories: 

bififind /dev/dak/lsSr/usr/lib -type d -print 
Finally, 

biffind /dev/rd9k/2s2:/users -type d -exec biflia -1 {} ; 

gives a long listing of every directory under /users on the device /dev/rdsk/292. 

AUTHOR 

Biffind was developed by HP. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

bif(4), find(l). 
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NAME 

bills - list contents of BIF directories 

SYNOPSIS 

bifls j -AadFiip j | device:names... ] 
bifll [ -AadFiip J [ device:naiiies... ] 

DESCRIPTION 

Bifls is iiitended to mimic is{V). 

A BIF file nanie is recogiiizod by the embedded colon (:) delimiter (see bif{4) for BIF file naming 

coaveuliuiis). 

For each directory named, bifls lists the contents of that directory; for each file named, bifls 

repeats its name tuid any ether information requested. 

If you are the sii})er-user, bifls defaults to listing all files except . (current directory) and .. (parent 

directory). If invoked by the name bifll, the -1 option is implied. 

There are several options to btfls: 

-a List ali entries; in the absence of this option, entries whose names begin with a period (.) 

arc not listed. 

-A The same as -a, except that the current directory "." and parent directory ".." are not 
listed. For the super-user, this flag defaults to ON, and is turned off by -A. 

d If argument is a director}', list oiily its name; often used with -1 to get the status of a 

directory. 

--F List with indicator of file type: / means a directory, * means executable. 

-I List the inode of a file or files. 

-i List in long format, giving mode, number of links, owner, group, size in bytes, and time of 

last modification for each file. 

- p Do not use /etc/passwd and /etc/group to interpret user and group ownership, but 

rather prijit out the numeric form. 

EXAMPLES 

The examples that follow assume that an BIF directory structure exists on the HP-UX device file 
/dev/rdsk/lsO. 

The first example will list all tlie files in the root directory of the BIF directory structure: 

bifis -a /dev/rdsk/lsO: 

The second example gives (in long format) all the information about the BIF directory 
/users/root itself (but not the files in the directory): 

bitls Td /dev/rdsk/lsOt/users/root 

WARNINGS 

Reniemljer, to olitain a listing of the BIF files on /dev/rdsk/lsO, you must not say 
bifls /dev/rdsk/lsO but you must include the colon, as in bifls /dev/rdsk/lsO:. If the colon 
is omitted, yen get a listing of the HP-UX file /dev/rdsk/lsO, not its BIF contents. 

AUTHOR 

Bif was developt;d by HP. 

FILES 

/etc/passwd to get user ids. 
/etc/groaj) to get group ids. 
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SEE ALSO 

bif(4), ls(l). 
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NAME 

binnKuir — maKe & Blr uirectory 

SYNOPSIS 

bifmkdir device:dimame ... 

DESCRIPTION 

Bifmkdir is intended to mimic mkdir(l). 

A BIF file name is recognized by the embedded colon (:) delimiter (see 6t/(4) for BIF file naming 
conventions). 

Bifmkdir creates specified directories in mode 777. The standard entries, . for the directory itself, 
and .. for its parent, are made automatically. 

RETURNS 

Bifmkdir returns exit code if all directories were successfully made; otherwise, it prints a diag- 
nostic and returns non-zero. 

EXAMPLES 

Create an empty subdirectory named sysmods imder the directory /usr/lib on HP-UX device 
/dev/d8k/280: 

bifmkdir /dev/dsk/2sO:/u8r/Iib /sysmods 

AUTHOR 

Bifvfas developed by HP. 

SEE ALSO 

bif(4), mkdir(l). 
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NAME 

bifrm, bifrmdir - remove BIF files or directories 

SYNOPSIS 

bi&m [ — fri ] device:file ... 

bifrmdir devicerdir ... 

DESCRIPTION 

Bifrm and bifrmdir are intended to mimic rm(l) and rmdir(l). 

A BIF file name is recognized by the embedded colon (:) delimiter (see bif{4) for BIF file naming 
conventions). 

Bifrm removes the entries for one or more files from a directory. If an entry was the last link to 
the file, the file is destroyed. 

If a designated file is a directory, an error conmient is printed (miless the optional argument -r 
has been used, see below). 

The options are: 

-f removes a file with no questions asked, even if the file has no write permission. 

— r causes bifrm to recursively delete the entire contents of a directory, and then the 

directory itself. Bifrm can reciu^ively delete up to 17 levels of directories 

— i causes bifrm to ask whether or not to delete each file. If — r is also specified, bifrrn 

asks whether to examine each directory encountered. 

Bifrmdir removes entries for the named directories, which must be empty . 

EXAMPLES 

The following examples assume that an BIF directory structure exists on the HP-UX device file 
/dev/rdsk/lsO. 

The first example recursively combs through the BIF directory /tmp and asks if each BIF file 
should be removed (forced, with no file mode checks): 

bifrm -irf /dev/rdsk/lsOz/tmp 

The second example removes the BIF directory /users/doug: 
bifrmdir /dev/rdsk/lsOt/users/doug 

AUTHOR 

Bifrm was developed by HP. 

SEE ALSO 

bif(4), rm(l), rmdir(l). 
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NAME 

bs - a compiler/interpreter for modest-sized programs 

SYNOPSIS 

bs [ file [ args ] ] 

DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C language thrown in. Bs is 
designed for programming tasks where program development time is as important as the resulting 
speed of execution. Formalities of data declaration and file/process manipulation are minimized. 
Line-at-a-time debugging, the trace and dump statements, and useful nm-time error messages all 
simplify progrfmi testing. Furthermore, incomplete programs can be debugged; inner functions 
can he tested before outer functions have been written and vice versa. 

If the command line file argument is provided, the file is used for input before the console is read. 
By default, statements read firom file are compiled for later execution. Likewise, statements 
entered i^om the console are normally executed immediately (see compile and execute below). 
Unless the final operation is assignment, the result of an immediate expression statement is 
printed. 

Bs programs are made up of input lines. If the last character on a line is a \, the line is contin- 
ued. Bs accepts lines of the following form: 

statement 
label statement 

A label is a name (see below) followed by a colon. A label and a variable can have the same 
name. 

A bs statement is either an expression or a keyword followed by zero or more expressions. Some 
keywords (clear, compile, !, execute, include, ibase, abase, and run) are always executed as they 
are compiled. 

Statement Syntax: 

expression The expression is executed for its side effects (value, assignment, or function 

call). The details of expressions follow the description of statement types below. 

break Break exits from the innermost for/while loop. 

clear Clears the symbol table and compiled statements. Clear is executed immedi- 

ately. 

compile [ expression ] 

Succeeding statements are compiled (overrides the immediate execution default). 
The optional expression is evaluated and used as a file name for further input. A 
clear is associated with this latter case. Compile is executed immediately. 

continue Continue transfers to the loop-continuation of the current for/while loop. 

dump [ name ] 

The name and corrent value of every non-local variable is printed. Optionally, 
only the named variable is reported. After an error or interrupt, the number of 
the last statement is displayed. The user-function trace is displayed after an 
error or stop that occurred in a ftmction. 

edit A call is made to the editor selected by the EDITOR environment variable if it is 

present, or erf(l) if EDITOR is undefined or null. If the file option is present on 
the command line, that file is passed to the editor as the file to edit. (Otherwise 
no file name is used.) Upon exiting the editor, a compile statement (and associ- 
ated clear) is executed giving that file name as it's argument. 
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exit [ expression ] 

Return to system level. The expression is returned as process status. 

execute Change to immediate execution mode (an interrupt has a similar effect). This 

statement does not cause stored statements to execute (see run below). 

for name = expression expression statement 
for name = expression expression 

next 

for expression , expression , expression statement 
for expression , expression , expression 

next The for statement repetitively executes a statement (first form) or a group of 

statements (second form) imder control of a named variable. The variable takes 
on the value of the first expression, then is incremented by one on each loop, not 
to exceed the value of the second expression. The third and fourth forms require 
three expressions separated by commas. The first of these is the initialization, 
the second is the test (true to continue), and the third is the loop-continuation 
action (normally an increment). 

funf([a,...])[v,...] 

nuf Fun defines the function name, arguments, and local variables for a user-written 

function. Up to ten arguments and local variables are allowed. Such names can- 
not be arrays, nor can they be I/O associated. Fimction definitions may not be 
nested. Calling an imdefined function is permissible, see function calls below. 

freturn A way to signal the failure of a user-written function. See the interrogation 

operator (?) below. If interrogation is not present, freturn merely returns zero. 
When interrogation is active, freturn trsmsfers to that expression (possibly by- 
passing intermediate function retimis). 

goto name Control is passed to the internally stored statement with the matching label. 

ibase N Ibase sets the input base (radix) to N. The only supported values for N are the 

constants 8, 10 (the default), and 16. Hexadecimal values 10-15 are entered as 
a-f. A leading digit is required (i.e., fOa must be entered as OfDa). Ibase (and 
obase, below) are executed immediately. 

if expression statement 
if expression 

[else . . .] 

fi The statement (first form) or group of statements (second form) is executed if 

the expression evaluates to non-zero. The strings and "" (null) evaluate as 
zero. In the second form, an optional else allows for a group of statements to be 
executed when the first group is not. The only statement permitted on the same 
line with an else is an if; only other /i's can be on the same line with a fi. The 
concatenation of else and if into an elif is supported. Only a single fi is required 
to close an i/ . . . elif . . . [ else . . . ] sequence. 

include expression 

The expression must evaluate to a file name. The file must contain bs source 
statements. Such statements become part of the program being compiled. 
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Include statements may not be nested. 

obase N Obase sets the output base to N (see ibase above). 

onintr label 

onintr The onintr command provides program control of interrupts. In the first form, 

control will pass to the label given, just as if a goto had been executed at the 
time onintr was executed. The effect of the statement is cleared after each inter- 
rupt. In the second form, an interrupt will cause 65 to terminate. 

return [expression] 

The expression is evaluated and the result is passed back as the value of a ftmc- 
tion call. If no expression is given, zero is returned. 

run The random number generator is reset. Control is passed to the first internal 

statement. If the run statement is contained in a file, it should be the last state- 
ment. 

stop Execution of internal statements is stopped. Bs reverts to immediate mode. 

trace [ expression ] 

The trace statement controls function tracing. If the expression is null (or evalu- 
ates to zero), tracing is turned off. Otherwise, a record of user-function 
calls/returns will be printed. Each return decrements the trace expression value. 

while expression statement 
while expression 

next While is similar to for except that only the conditional expression for loop- 

continuation is given. 

! shell command An immediate escape to the Shell. 

# . , . This statement is ignored. It is used to interject conmientary in a program. 

Expression Syntax: 

name A naxae is used to specify a variable. Names are composed of a letter (uppercase 

or lowercase) optionally followed by letters and digits. Only the first six char£ic- 
ters of a name are significemt. Except for names declared in fun statements, all 
names are global to the program. Names can take on nmneric (double float) 
values, string values, or can be associated with input/output (see the built-in 
function open{) below). 

name ( [expression [ , expression] . . . ] ) 

Functions can be called by a name followed by the arguments in parentheses 
separated by commas. Except for built-in functions (listed below), the name 
must be defined with a fun statement. Argiunents to functions are passed by 
value. If the function is undefined, the call history to the call of that function is 
printed, and a request for a return value (as an expression) is made. The result 
of that expression is taken to be the result of the imdefined function. This per- 
mits debugging programs where not all the functions are yet defined. The value 
is read from the current input file. 

name [ expression [ , expression ] . . . ] 

This syntax is used to reference either arrays or tables (see built-in table func- 
tions below). For arrays, each expression is tnmcated to an uiteger and used as 
a specifier for the name. The resulting array reference is syntactically identical 
to a name; a[l,2] is the same as a[l][2]. The truncated expressions are res- 
tricted to values between and 32 767. 
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match("al23abl23", ".♦\([a-z]\)") == 6 
mstring(l) == "b" 

File handling 

open(naine, file, function) 

close (name) The name argument must be a bs variable name (passed as a string). For the 
open, the file argument may be 1) a (zero), 1, or 2 representing standard 
input, output, or error output, respectively; 2) a string representing a file name; 
or 3) a string beginning with an ! representing a command to be executed (via 
sh -c). The function argmnent must be either r (read), w (write), W (write 
without new-line), or a (append). After a close, the name reverts to being an 
ordinary variable. If name was a pipe, a wait{2) is executed before the close 
completes. The 6a exit command does not do such a wait. The initial associa- 
tions are: 

open("get", 0, "r") 
open("put", 1, "w") 
open("puterr", 2, "w") 

Examples are given in the following section. 

access(s, m) executes access{2). 

ftype(8) retiuns a single character file type indication: f for regular file, p for FIFO (i.e., 

named pipe), d for directory, b for block special, or c for character special. 

Tables 

table(nanie, size) 

A table in bs is an associatively accessed, single-dimension array. "Subscripts" 
(called keys) are strings (numbers are converted). The name argimient must be 
a bs variable name (passed as a string). The size argument sets the minimum 
niunber of elements to be allocated. 55 prints an error message and stops on 
table overflow. The result of table is name. 

iteni(nanie, i) 

key() The item function accesses table elements sequentially (in normal use, there is no 

orderly progression of key values). Where the item function accesses values, the 
key function accesses the "subscript" of the previous item call. It fails (or in the 
absence of an interrogate operator, returns null) if there was no valid subscript 
for the previous item call. The name argument should not be quoted. Since 
exact table sizes are not defined, the interrogation operator should be used to 
detect end-of-table; for example: 

table("t", 100) 

# If word contains "party", the following expression eidds one 

# to the count of that word: 
++t[word] 

# To print out the the key /value pairs: 

for i = 0, ?(s = item(t, i)), -f-+i if key() put = key()_":"^s 

If the interrogation operator is not used, the result of item is null if there are no further elements 
in the table. Null is, however, a legal "subscript". 

iskey(nanie, word) 

The iskey function tests whether the key word exists in the table name and 
returns one for true, zero for false. 
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Odds and ends 

eval(8) The string argument is evaluated as & bs expression. The function is handy for 

converting numeric strings to numeric internal form. Eval can also be used as a 
crude form of indirection, as in: 

name = "xyz" eval("++" name) 

which increments the variable xyz. In addition, eval preceded by the interroga- 
tion operator permits the user to control bs error conditions. For example: 

?eval(''open(\"X\", \"XXX\", \"r\")'') 

retiuTis the value zero if there is no file named "XXX" (instead of halting the 
user's program). The following executes a goto to the label L (if it exists): 

label="L" 

if !(?eval("goto " label)) puterr = "no label" 

plot (request, args) 

The plot function produces output on devices recognized by tplot{l). The 
requests are as follows: 

Call Function 

plot(0, term) causes further plot output to be piped into tplot{l) with 

an argument of -Tterm. Term may be up to 40 charac- 
ters in length. 

plot(l) "erases" the plotter. 

plot(2, string) labels the current point with string. 

plot(3, xl, yl, x2, y2) draws the line between {xl,yl) and {x2,y2). 

plot(4, X, y, r) draws a circle with center {x,y) and radius r. 

plot(5, xl, yl, x2, y2, x3, y3) draws an arc (coimterclockwise) with center {xl,yl) and 
endpoints {x8,y2) and {xS,yS). 

plot (6) is not implemented. 

plot(7, X, y) makes the current point {x,y). 

plot(8, X, y) draws a line from the current point to {x,y). 

plot(9, X, y) draws a point at {x,y). 

plot(10, string) sets the line mode to string. 

plot(ll, xl, yl, x2, y2) makes {xl,yl) the lower left comer of the plotting area 

and {x2,y2) the upper right comer of the plotting area. 

plot(12, xl, yl, x2, y2) causes subsequent x (y) coordinates to be multiplied by 

xl [yl) and then added to x2 {y2) before they are plot- 
ted. The initial scaling is plot(12, 1.0, 1.0, 0.0, 0.0). 

Some requests do not apply to all plotters. All requests except zero and twelve are imple- 
mented by piping characters to tplot{\). See p/of(4) for more details. 

Each statement executed from the keyboard re-invokes tplot, making the results unpredictable if a 
complete picture is not done in a single operation. Plotting should thus be done either in a func- 
tion or a complete program, so all the output can be directed to tplot in a single stream. 

Ia8t( ) in immediate mode, last returns the most recently computed value. 

Programming Tips: 
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NAME 

cal - print calendar 

SYNOPSIS 

cal [ [ month ] year ] 

DESCRIPTION 

Cal prints a calendar for the specified year. If a month is also specified, a calendar just for that 
month is printed. If neither is specified, a calendar for the present month is printed. Year can be 
between 1 and 9999. The month is a nimiber between 1 and 12. The calendar produced is that 
for England and her colonies. 

Try September 1752. 

BUGS 

The year is always considered to start in January even though this is historically naive. 
Beware that "cal 83" refers to the early Christian era, not the 20th century. 
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NAME 

calendar - reminder service 

SYNOPSIS 

calendar [ - ] 

DESCRIPTION 

Calendar consults the file calendar in the current directory and prints out lines that contain 
today's or tomorrow's date anywhere in the line. Most reasonable month-day dates such as "Aug. 
24," "august 24," "8/24," etc., are recognized, but not "24 August" or "24/8". On weekends 
"tomorrow" extends through Monday. 

When an argument is present, calendar does its job for every user who has a file calendar in the 
login directory and sends them any positive results by mai/(l). Normally this is done daily in the 
early morning hours under control of cron (IM). 

FILES 

calendar 

/tmp/cal* 

/usr/lib/calprog to figure out today's and tomorrow's dates 

/usr/lib/crontab 

/etc/passwd 

SEE ALSO 

cron(lM), mail(l). 

BUGS 

Yom- calendar must be public information for you to get reminder service. 
Calendar's extended idea of "tomorrow" does not account for holidays. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 



SYNOFSIP 
cat 



cat - concaienatf. copy, aixd pnni t\^t:-^ 
1 ! i --s i i -v i--t] ^~-e; ' tile 



DESCRIPTION 

Cat reads each file iii j-eqiu-nce aivi wiitcs it ori the standard uutpu!. Th'j.-; 

cat lilr 
prLiis tht fiU;. and. 

'■at fikd H'^-2 ■>fii*-3 
concateridte.'; the first two files 'diA places the result an *^he third, 
ii no iivpui hit- IS givcji. in n tii*- HigiHiic^iv - is fiuouniijfr-d, (:i! it i,u- ;i. 

■■U- i-i;ibh'-'- V1'! t- r : i^Miwi t) .. J.r.) \-.:-y,t i.-,tV. -tl)^>,- fijpc 



The "ptio!iH riff 



c;i,i;-fK outp'n ty V;c M"bu*fcred (charartfr-by-charart»r!: u ;n-iaii\\ outj>'it •■^ 
ijijuered. 

raakps r-it sdenf about iion- existent hies, ideiitiCii! input :i!i(i output, aijd \vrite 
erroi>- Nonoally, no iuput file may be the SAnio fis tlit- output til:' unless it is a 
spc(iai iile (The 4.2IiHI) cat -s huuurc is provided by ,;3p(i].) 

caij^.'s non-printing characters (with the oxccpt;nn of tabs, ncwdincs and forn)- 
teed:^) to he printed visibly. (o!itn)l characters arc printed 'X (control- A^); the 
DEL chai-artf! (cc^d ')177* is pn:.trd "?. Non-AH(dI charaf t'-rv f-vi1h the h^gh 
bit set) 'iu^ pr'ntcd a« M-j. v^herp 7 is iho charftctc- SiX^cihed by tlic sevci! hiw 



tvh. 



'! -.vith the -v OT-'- 



"f causes t:dw to l,r pin;wd as "lb 

-s? w}icn used with the -v optiu:,- < aases a $ iharactc! t'> b.;' jirin'cd al the eiu! '-f 

each line (prior to the ncv/ Inic) 

The - X, and -c apSiijic^ air '.y^\- nvn li lb'-- -v upLc; i-. ,iO? Sj.ku:,! d 

SEE ALSO 



WARNING 

Coui.nand foviiiats s';;d; a:- 

cat idcJ die.;' >nici 

;n-erwntes {'\e data b: jA^ I 's ''.-*- i'l- *^,:.c 
spccia! ch;ira< ters. 

INT EilN A TION AL SUPPORT 

?- a.rJ 16-bit data, b-bu blcTianic-, ;;'fs^agc■ 



a ''Cf^i 



r.'b.r.' t.ik* c,H-« 
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NAME 

ch - (.' i-!x<graiii beaut itier. formatter 

SYNOPSIS 

cb [ - « ! f -j ! [ -~i Icng j [ file ... i 

DESCRIPTION 

Ch rca.'-. C uiov^iaiii? i-illier iruiii iis arguments or from the iitandard mpiit aiui writes llieui on 
(lie standard output with sp'icing and incicntaticn that displays the stn:cture of the code. Under 
ilefault, (iptions, cl; ijreKervcs all user new-lines, liiider the -s fiag ch canoRicaJizes the code to the 
otylc -ji KoriiigLan cUid niteiiie lu The (7 Frugramminij Laaunagt. i'ue -j liag catises spilt imps to 
Vie put bdelc together, i'lie -1 flag causes cb to i.plit lines that are ionger than leng. 

SEE ALSO 

ceil i. 



';f (" Fr.Hjranimrng i'lrigvage !)> B. \V. KenughHa ;nu\ D. M. Rit* 



BUGS 



i'tnictuatiun that is hidden in preprocessor statements; will cat'^e iiidentnti;.;; errors. 

INTERNATiONAL SUPPORT 

8- aud !(>i)d. d;ila, 8d;it lilehames, 
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NAME 

cc - C compiler 

SYNOPSIS 

cc [ options ] files 

DESCRIPTION 

Cc is the HP-UX C compiler. It accepts several types of arguments: 

(1) Argmnents whose names end with .c are taken to be C som-ce programs. They are compiled 
and each object program is left on the file whose name is that of the source with .o substi- 
tuted for .c. However, if a single C program is compiled and linked all in one step, the .o 
file is deleted. 

(2) Similarly, arguments whose names end with .8 are taken to be assembly source programs 
and are assembled, producing a .o file. 

(3) Arguments whose names end with .o are taken to be relocatable object files that are to be 
included in the link operation. 

Arguments can be passed to the compiler through the CCOPTS environment variable as well as 
on the command line. The compiler picks up the value of CCOPTS and places its contents 
before any arguments on the command line. For example (in sh{\) notation), 

CCOPTS=-v 
export CCOPTS 
cc -g prog.c 

is equivalent to 

cc -V -g prog.c 

Options 

The following options are recognized by cc. 

-c Suppress the link edit phase of the compilation, and force an object (.o) file to be 

produced for each .c file even if only one program is compiled. Object files pro- 
duced ft-om C programs must be linked before being executed. 

-C Prevent the preprocessor from stripping C-style comments. See cpp(l) for 

details. 

-Dname^def 

-Dnome Define name to the preprocessor, as if by '#define'. See cpp(l) for details. 

-E Rim only cpp(l) on the named C or assembly programs, and send the result to 

the standard output. 

— g Cause the compiler to generate additional information needed by the symbolic 

debugger. 

-Idir Change the algorithm used by the preprocessor for finding include files to also 

search in directory dir. See cpp(l) for details. 

-\x Cause the linker to sesirch the library libz-a. See /d(l) for details. 

— n Cause the output file from the linker to be marked as shareable. For details and 

system defaults, see ld{\). 

-N Cause the output file from the linker to be marked as unshareable. For details 

and system defaults, see M(l). 

-o outfile Name the output file from the linker outfile. The default name is a.out. 
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-O Invoke the optimizer. 

-p Arrange for the compiler to produce code that comits the niunber of times each 

routine is called. Also, if link editing takes place, replace the standard startoff 
routine by one that automatically calls monitor {3C) at the start and arranges to 
write out a mon.out file at normal termination of execution of the object pro- 
gram. An execution profile can then be generated by use of prof{l). 

-P Run only cpp(l) on the named C programs and leave the result on corresponding 

files suflBxed .i. 

-q Cause the output file from the linker to be marked as demand loadable. For 

details and system defaults, see ld{l). 

-Q Cause the output file from the linker to be marked as not demand loadable. For 

details and system defaults, see W(l). 

-8 Cause the output of the linker to be stripped of symbol table information. The 

use of this option will prevent the use of a symbolic debugger on the resulting 
program. See W(l) for more details. 

-S Compile the named C programs, and leave the assembly language output on 

corresponding files suffixed .s. 

-t c,name Substitute or insert subprocess c with name where c is one or more of a set of 

identifi^ indicating the subprocess (es). This option works in two modes: 1) if c 
is a single identifier, name represents the full path name of the new subprocess; 
2) if c is a set of identifiers, name represents a prefix to which the standard 
suffixes are concatenated to construct the full path names of the new sub- 
processes. 

c can take one or more of the values: 

p preprocessor (standeird suffix is cpp) 
c compiler body (standard suffix is ccom) 

same as c 

a assembler (standard suffix is as) 
2 optimizer (standard suflBx is c2) 

1 linker (standard suffix is Id) 

-Unome Remove any initial definition of "name" in the preprocessor. See cpp(l) for 

details. 

-V Enable verbose mode, which produces a step-by-step description of the compila- 

tion process on stderr. Also echoes CCOPTS if it is set. 

-w Suppress warning messages. 

-W c,argl[,arg8...] 

Hand ofiF the argiunent[s] argi to pass c where c can assmne one of the values 
listed imder the -t option as well as d (driver program). The -W option 
specification allows additional, implementation-specific options to be recognized 
by the compiler driver. For exsimple, on the Series 300, 

-W d,-x 

causes the driver to call various subprocesses needed to generate MC68020 code. 
Furthermore, a shorthand notation for this mechanism can be used by placing 
"+" in front of the option name as in 

+x 
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which IS cquivaltii' to the previous option example. Sunit cuniniani}- ustxi svAy 
process optiotis caij also he abhreviated in a similar fashion. Notr tiiat fpr Kiinpii- 
cjty, iLis sLortha,!}'! must be applied to each option individually. Opt'cns th-j.*: 
can W abbreviated using " + " are iniple:nf:ntation-depou if :d. ;i:,!i are listc' 
under HAHDWAilK DEI-ENDENCIES. 

~y. Do not bind anything te, address zero. This option will allcv.' rtintiuie detett;oii 

of null pointers. See the not<= on pointers below . 

-Z Allow dereferenciDH ■>( nu.i.i pointers. See tlie note on pointer.'^ below. 

A.i!y ot'.er options enronntered v/ill generate a wammg to stderr. 

(/ther arguuients are laken to be (. -eoinpatihie objeel piograiiis, typically prauoi ^ d b> an cMhr: 
( .' ni!/. 01 perhaps libraries nf C-cooipatible routines. These j^rograms, together with the results 
• f" :i;\' • >'::pi! it iA^f wppfififv^ '>ji> !ir)kr-d (iri t^ip fird*»r jrivprii ti, j)rr,dvi(e an /^x/'f ;i'^:^;<'." ].roarr,rir!i 
wJl-i t]:e iiainc a. cut. 

The K;ndghan and Ritchie C text, and the various addenda to it. comprise t'l,: best available 
refert'rce on ('. 'i'lic docuinenrs aie iiitentioaally ambiguous in some aieiis. Hl'-l'X specifies some 
ol t ]!( se beli>^v , 

char 

'.Ciie ch.ar type is treated as signed by default. It may be declared unsigned. 

p"^-l"ter=i 

\' ( '^ ' •■ M ^'^ I I /t 1 1 1 -) )i it f r !■> t( ( nn < \\\ e '■>' (^^( i\t ri a uj m " o. '^ it 

t)i t 1 A V V t t ■, hav( pci 1 itud * m tl e i i'-' T e *" d w ni/ i^ ^ i nidfd * i lx ai i i t^o' 
t d lilt f( J j} f ' i'-i«,i'-f 1^ abh t > leturn zer" t-^r r-^ad^ ^Ijt d n zcr' hen ic es^ z 
* f I i" a 1 1 1 j t ( ) t Hi ! t d ; ■^ i i c tlu -z 1 ^ prt t i Pi t. ^ 

\ > < ' t i if ^t t - ^ ) It r ^ r i i< ' s\r T ^ ' 

ji ( i-^v < Uc't ( vc 1 *' i< -ii lit t 1* th t.^id I ci ^ jr t t 

( ' tri ad 1* t w 1 t il /I 1 ♦!) ztr i i 1 ( Vh 1 at ?eri th^ hud«. r '-i > I'd < *" <_ 

if t 1 z ug IS fv et 

idfr'ntitlers 

Idpiitiiiei-s ;<!,■ ^iirni'H.ee iip ;<) 2UIp cliiUaciei^ 

types 

rertuin protrrui-iS req;;!;; tfiat a type be a sj^ecifie nund^er of bits wide It can ""le assumed f'lat 
an tnt can jioid at ieas: ,i^ luuch nilonnatU/U as a sti-ni. and that a ioriij can ;iolcl at ;e;ist ^^ 
much iiiforination as aa lai. Additionally, either an ini or a i or;.;/ can hold a j;:>i!;!er 

HA.RDWAHE DEPEN.OENCIE'-- 

Thef 1 H,Ou, - " lU, M, , .1', ; ^^ I 

!'• . h t . ,/ . . , d' ; -re. . 1, i ' cf ' uii 1 <■ / - e, Z \ .- ^ » tl ' * 

Td. '. fa.!f .'^ p 1 < jJ '^' 1 I, c . . • ' "- ! . ;i ' . .in < ,vhw> '' . , I r e ,- 

t ik.n=; p! <> ' ; ... i^ It : a ••<! i- .mj" "s rr, . ' 1' ' c '_"J pi .st^- ;r f ,i i >; di ^ i 
-i,ui .!< Vt Lz-K. >. 

Ih - V i ."'. 1 V I : r "h rd' "r- - > n '\ ' ' I -E n M ' .-,■''' ^ 
.yitsed t'' it ti./'n " i If, il < -'rV J op ^ 

4'X or -W d," -x 

cause-; ;i.ii: ti)i:ipiif-i i-.i ;ri:iierate iaaae t i.^de f,a tlie M(.b3Li2i! and MEbcc;^!. 

4X -jT -W d, dS. 

cause-; :ia (^unpilt i I ; griariSv "gcneiii "' M(',80ip (..!;• Th« • A-: vi" .d-;- ru', 
on Mci!ji.u2u pr^. es^ors. bur ii will not rake advaiita^e of .oi v. afoiarictuiai 
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Thv conpik'r snbprccess ccom supports the ffi'k^whig options, whirb may be pa3S>.;d to it 
fi<.i,{ c€ using ihp -W c option. Some of these can be passcii directly to the d^ivor ^isivig tLe 
' t- notatioiL 

+ b or - W c- b 

c-><'.<p^ the M<''68t>10 ronipiier te get-cratc oodc for floAtirig ixMui ;?p.:,.i!.io.!is rLai 
n;!! use the 98635 ficatiiig point card if it is iaolyikKi iu tti*; computer at run-time 
(if ii'it itiStalieu, operations will be done in software). Tnis opiicu canniit he used 
s^-iiesi rnrle '? bf^inff Eetierated ex^vi'iUv tor the MCC3020 i;ithCi bv defiiuit iiu a 
AlCGau2i; Uii^ied jyciitiii or via itie t-x option. 

f F or -VV c, i 

; aujie?. tni> MvIubOlt; conipiier lo j^eneraie code for tloatmg point cj^erations that 
mil;- use the HSiV.]'^ floating p'-mi ' ard. 'Jd.is cade does uot lar: u,de;is the float- 
rig point card is installed. Tids ep>ioi,i CHiinoi Ix used whi'ii codt: is i>ei!!g gen- 
.-raSed ex])lici(!v for the M("'6802C, ealicr by defaib' on a M<''b8ti2t: b^i-ed /.ystei:; 
or vj" ! he -|-x "pi ion, 

-t ? -f W r M 

in ^ ' t'si 2 11 r \ t > 1 If r ( (1 t V f- > I , ^ 

p((.f~s '• ' lb a-' »-( t n s \ 1 1 f^ it+< i-( e' r r-Pt'trr j b h^ Tiaa 

t b ^ I \b i - jU t ^d t I 1 lO ill 11 i A, ij f > 

.: 1^ ^ r . r 'vV -^ 

( ^ ^ t< i.e tain it« u< I r ( I r , ( ■■ ( , ' t cr- f 

^ibviepstw> ^nd n IS ai i ttger s<-t -u^'f i( ^ * <M ^t n, T} ^ 

*" b > z,<>- a'l ' t <■< >IHt f !- t t •"flf m l'^ If ♦^ri iS J ' t ' J [ rf 

tl ' V 

a niOXiintHn size of the asciz table. bJefault is iWiOG faoie eritries. 

b riiaj^inium size of the be table. Tins table saves break and coii- 

diiue labt-L within ioups and switch statemenis. i.)efaulr is UM' 
iid>!e eniries. 

d niaxiinuin s-ize nf rlie dirniab table rins table maintains infornia- 

rion ationt the derinitiuiiS o;' al; ~! 'iirtures. uriLiis. and arrays. 
Default is 1000 taide entries. 

e maxinaiui nnniber of nodes per staternent. Default is 350 table 

entries 

p nuixiniurn size of the paraineter stack. Defaidt is 150 table entries. 

3 ;;.:i.xiauiin size of 'hi' symtKsi table Defaidt i-^ iOOO tabb fiicrjes, 

t niaxmaiin size of -!,,■ ui:iivi table. Defauii is 2tlOni) lalde .runes, 

vv inaAimui-i -i/e ot ibc '-wireh tabic stnck. Delanlt is i:aO taliile 



I * ,ni c.ia->e-. o"nt i.uli ' u<-^ ti '^i o-int)d on die asdenibly i,s) hie as asseni- 
■ii'iei ts ',h-i- ^i o'Air;; the correopondence between C source an^.! the re^uhing 
iv ■ ode 

o'.on i-i -uooorted: 
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-Y Enable support of 16-bit characters inside string literals and comments. Note that 
8-bit parsing is always supported. See hpnls{5) for more details on International 
Support. 

Series 500: 

The following options are not supported: -p, -w. 

The default is not to allow null pointer dereferencing, hence using -z has no effect. 

The file /lib/mcrtO.o is not currently supported. 

The compiler subprocess ccom supports the following options, which may be passed to it 
from cc using the -W c option. Some of these can be passed directly to the driver using the 
"+" notation. 

+N<secondary><n> or -W c,-N<secondary><n> 

This option adjusts the size of internal compiler tables. The compiler uses fixed size 
arrays for certain intemsd tables. Secondary is one of the letters from the set 
{bpwgi}, and n is an integer value. Secondary and n are not optional. The table 
sizes can be re-specified using one of the secondary letters and the niunber n as fol- 
lows: 

b maximum size of the be table. This table saves break and continue 

labels within loops and switch statements. Defatdt is 100 table 
entries. 

p maximmn size of the parameter stack. Default is 150 table entries. 

g maximum size of the argimaent stack. Default is 100 table entries. 

w maximxun size of the switch table. Default is 250 table entries. 

i maximmn size of the instruction table for generated code. Default 

is 300 table entries. 

The following option is supported: 

-Y Enable support of 16-bit characters inside string literjils and comments. Note that 8- 
bit parsing is always supported. See hpnls{5) for more details on International Sup- 
port. 

Series 800: 

The default is to allow null pointer dereferencing, hence using -Z has no effect. 

The -g option is incompatible with optimization. 

The compiler subprocess ccom supports the following options, which may be passed to it 
from cc using the -W option. Note: The "-foptl -l-opt2" notation may be used instead of 
the "-Wc,-optl,-opt2" notation. 

-|-a or -W c,-a 

When processing files which have been written in assembly language, do 
not assemble with the prefix file which sets up the space and subspace 
structure required by the linker. Files assembled with this option may not 
be linked unless they contain the equivalent information. 

+Oopt or -W c,-Oopt 

Invoke optimizations selected by opt. If opt is '1', then only level 1 optimi- 
zations are hsmdled. If opt is '2', then all optimizations are performed. 
The option -|-02 is the same as -O. 

EXAMPLE 

The following will compile the C program prog.c, creating a prog.o file, and will then invoke the 
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link editor W(l) to link prog.o and procedure. o with all the C startup routines in /lib/crtO.o and 
library routines from the C library libc.a; the resulting executable program is output in prog: 

cc prog.c procedure.o -o prog 



FILES 



file.c 

file.o 

a.out 

/tmp/ctm* 

/usr/tmp/ctm* 

/lib/cpp 

/lib/ccom 

/lib/c2 

/bin/as 

/bin/Id 

/lib/crtO.o 

/lib/mcrtO.o 

/lib/libc.a 

/usr/include 

Series 200, 300: 
/lib/ccomlO 

/lib/ccom20 

/lib/c210 
/lib/c220 
/bin/aslO 

/bin/as20 



input file 

object file 

linked output 

temporary 

temporary 

preprocessor 

compiler, cc 

optional optimizer (for Series 200, Series 300 and Series 500 only) 

assembler, oa(l) 

Imk editor, W(l) 

nmtime startoff 

startoff for profiling 

standard C library, see section 3 of this manual 

standard directory for ^include files 



compiler, MC68010 version (linked to /lib/ccom on MC68010 sys- 
tems). 

compiler, MC68020 version (linked to lib/ccom on MC68020 sys- 
tems). 

optimizer, MC68010 version (linked to lib/c2 on MC68010 systems). 
optimizer, MC68020 version (linked to lib/c2 on MC68020 systems), 
assembler, MC68010 version (linked to /bin/as on MC68010 sys- 
tems). 

assembler, MC68020 version (linked to /bin/as on MC68020 sys- 
tems). 



C library for profiled programs 
compiler messages catalog 



Series 800: 
/lib/libp/libc.a 
/usr/Iib/cc msgs.cat 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages may 
be produced by the assembler or the link editor. 

WARNINGS 

Options not recognized by cc are not passed on to the link editor. The option -W l,arg may be 
used to pass any such option to the link editor. 

By default, the return value from a C program is completely random. The only two guaranteed 
ways to return a specific value are to explicitly call exit{2) or to leave the function main() with a 
'return expression;^ construct. 

SEE ALSO 

adb(l), cdb(l), cpp(l), as(l), ld(l), prof(l), exit(2), monitor(3C), matherr(3M). 

B. W. Kemighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978. 

INTERNATIONAL SUPPORT 

8- and 16-bit data only in strings and comments, 8-bit filenames. 
Series 800 does not support 16-bit data. 
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NAME 

cd - change working directory 

SYNOPSIS 

cd [ directory ] 

DESCRIPTION 

If directory is not specified, the value of shei) parfiineter IHOME is used as the new working 
directory. If directory specifies a complete path startiiig v.-ith /, ., . ., dirtct.ny Ix'comes the new 
v/orking director^'. If neither case apphes, cd tries to find the designated director}' relative to one 
of the paths specified by the $CDPATH shell variable, ICDl'ATK has the same s3/ntax as, and 
similar semantics to, the SPATH shell variable Cd niust have execute (searchi permission in 
directory . 

Because a new process is created to execute ezA comrnai^d. cd vfould be ineffective if it were writ- 
ten as a normal conunand; therefore, it is recognized and is internal to the shell. 

VARIABLES 

HOME default working directory 

CDPATH directories to search for dirertorv'. 

SEE ALSO 

pwd(l), sh(l), chdir(2). 

INTERNATIONAL SUPPORT 

8-bit filenames, messages 
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NAME 

cdb, fdl;, pdl,' - C, FORTRAN, Pascal symbolic debugger 

SYNOPSIS 

cdb i-d dir] [-r file] {-p file] |-S num] [objectfile [corefUe]] 

fdb f cdh options I 

pdb i cdb options i 
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DESCRIPTION 

Cdh, fdb, aiid p<i6 are alternate names for a source level debugger for C, KP FORTRAN, and HP 
Pascal programs. It provides a ccaitrolled environment for their execution. 

Objectfile is an executable program file having one or more of its component modules compiled 
with the -g cption. The main procedure (main program) must have been comj>iled with -g. The 
support module /usr/tih/end.o must be mciuded as the last object file in the list of those linked, 
except for libraries included with the -1 option to W(l). (done automatically with -g option to 
ceil), fc{l), and pc{l)]. The default for objectfile is a.out. 

Corefik is a core image from a failed execution of objectfile. The default corefile is core. 

The options are: 

-d dir naiiifes an aiternate directory where source files are located. (The current directory is 
se;irched last.) 

-r file naraes a record file which is invoked immediately (for overwrite, not for append). 
Used with, Record and Playback Commands. 

-p file nanii's a playback file which is invoked immediately. Used with Record and Play- 
back Commands. 
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-S num sets the size of the string cache to num bytes (default is 1024). The string cache holds 
data read from objectfile. 

Only one objectfile and one core file are allowed per debugging session. The program {objectfile) is 
not invoked as a child process imtil an appropriate Job Control Command command is given. 
The same program can be restarted many times (as dififerent child processes) dining a single 
debugging session. 

CONVENTIONS 

The debugger remembers the ciurent file, current procedure, current line, and cmrent data loca- 
tion. They are a function of what you have been viewing (not necessarily executing) most 
recently. Many commands use these current locations as defaults, and many commands set them 
as a side effect. It is important to keep this in mind when deciding what a command does in any 
particular situation. 

For example, if you stop in procedure "abc", then view procedmre "def, then ask for the value of 
local VEiriable "xyz", the debugger assumes that the variable belongs to procedure "def". 

Notational Conventions 

Most commands are of the form "[modifier] command-letter [options]". Nmneric modifiers before 

and after commands can be any numeric expression. They need not be just simple nmnbers. A 

blank is required before any numeric option. Multiple commands on one line must be separated 

by ";". 

These are common modifiers and other special notations: 

(A I B I C) Any one of A or B or C is required. 

[A I B I C] Any one of A or B or C is optional. 

file A file name. 

proc A procedure (or function, or subroutine) name. 

var A variable name. 

number A specific, constant number (e.g. "9", not "4+5"). Floating point (real) nmnbers 

may be used any place a constant is allowed. 

expr Any expression, but with limitations stated below. 

depth A stack depth, as printed by the "t" command. The top procedure is at a depth of 

zero. A negative depth acts like a depth of zero. Stack depth usually means 
"exactly at the specified depth", not "the first instance at or above the si)ecified 
depth". 

format A style for printing data. Used with Data Viewing Commands. 

commands A series of debugger commands, separated by ";", entered on the command line or 
saved with a breakpoint or assertion. Semicolons are ignored (as commands) so 
they can be freely used as command separators. Commands may be grouped with 
"{}" for the "a", "b", "if", and "!" commands. In all other cases commands inside 
"{}" are ignored. 

Variable Name Conventions 

Variables are referenced exactly as they are named in your source file(s). Case sensitivity is con- 
trolled by the "Z" command. Be careful with one letter variable names, since they can be con- 
fused with commands. If an expression begins with a variable that might be mistaken for a com- 
mand, just enclose the expression in "()" (e.g. "(k)"), or eliminate any white space between the 
variable and the first operator (use "k= 9" instead of "k = 9"). 

If you are interested in the value of some variable var, there are a munber of ways of getting it, 
depending on where and what it is: 
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var Search the stack for the most recent instance of the current procedure. If found, 
see if var is a parameter or local variable of that procedure. If not, search for a 
global variable named either var or var, in that order. 

proc.var Search the stack for the most recent instance of proc. If foimd, see if it has a 

parameter or local variable named var, as before. 

proc,depth.var Use the instance of proc that is at depth depth (exactly), instead of the most 
recent instance. This is very useful for debugging recursive procedures where 
there are multiple instances on the stack. 

:var Search for a global (not local) variable named either var or —var, m that order. 

Dot is shorthand for the last thing you viewed. It has the same size it did when 
you last viewed it. For example, if you look at a long as a char, then "." is 
considered to be one byte long. This is useful for treating things in imconven- 
tional ways, like changing the second highest byte of a long without changing 
the rest of the long. Dot may be treated like any other variable. 

NOTE: "." is the name of this magic location. If you use it, it is dereferenced 
like any other name. If you want the address of something that is, say, 30 bytes 
farther on m memory, do not say ".+30". That would take the contents of dot 
and add 30 to it. Instead, say "&:.+30", which adds 30 to the address of dot. 

Special variables are names for things that are not normally directly accessible. Special variables 
include: 

$var The debugger has room in its own address space for a number of user-created special vari- 
ables. There are 26 of them by default (this nmnber is adjustable using the -s invocation 
option). They are all of type long, and do not take on the type of any expression they 
are assigned. Names are defined when they are first seen. For example, saying "$xyz = 
3*4" creates special symbol "$xyz", and assigns to it the value 12. Special variables may 
be used just like any other variables. 

$pc, $fp, $sp, $rO, etc. 

These are the names of the program counter, the fi*ame pointer, the stack pointer, the 
registers, etc. To find out which names are available on your system, use the "1 r" (list 
registers) command. All registers act as type integer. 

Sresult 

This is used to reference the return value from the last command-line procedmre call. 
Where possible, it takes on the type of the procediu-e. Sshort and $long are available as 
alternate ways of looking at (result. 

$signal 

This lets you see and modify the current child process signal number. 

$lang This lets you see and modify the current language (0 for C, 1 for FORTRAN, or 2 for Pas- 
cal). 

$line This lets you see and modify the current source line nmnber, which is also settable with a 
nimiber of diflFerent conunands. 

Smalloc 

This lets you see the current amoimt of memory (bytes) allocated at run-time for use by 
the debugger itself. 

$cBad This lets you see and modify the number of machme instructions the debugger will step 
while in a non-debuggable procedure before setting an up-level breakpoint and free- 
nmning to it. Setting it to a small value can improve debugger performance, at the risk 
of taking off free-nmning after missing the up-level break for some reason. 
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$pagelines 

This lets you set the number of lines per "page" of debugger output. The prompt "Hit 
R,ETURN for more..." occurs between pages. Values of zero or less turn off paging. 

To see all the special variables, including the predefined ones, use the "1 s" (list sjx^cials) com- 
mand. 

You can also look up code addresses with 

proci^line 

which searches for the given procedure name and line number (vvhich muist be an executable line 
within proc) and uses the code address of that line. Just referring to a procedure pToc by name 
uses the code address of the entry point to that procedure 

Expression Conventions 

Every expression has a value, even simple assigimient statemenis. as in C iNaked expression 
values (those which aren't command modifiers) are always printed unless the next toixT; is ";" 
(command separator) or "}" (command block terminator). Thus breakpoint and assertion com- 
mands are normally silent. To force an expression result to be printed, follow the expression with 
" /n" (print in normal format). 

Integer constants may begin with "0" for octal or "Ox " or "OX" for hexadecimal (the forms are 
equivalent). They are int (which may be the same as long) if they fit in two bytes, long other- 
wise. If followed immediately by "1" or "L", they are forced to be of type long (this is useful on 
systems where int is two bytes). 

Floating point constants must be of the form digits.dtgitslelEldil) [+\-\digita]. for example 
"1.0", "3.14e8", or "26.62D-31". One or more leading digits is required to avoid confusion with 
"." {dot). A decimal point and one or more following digits is required to avoid confusi'iii fjr 
som.e command formats. If the exponent doesn't exactly fit the pattern shown, jt is iK)t taken a.^; 
part of the nmiiber, but as separate token(s). The "d' and 'D" exponent forms are allowed fur 
compatibility with FORTRAN. However, all floating point constants are taken as doubles, regard- 
less. 

Character constants must be entered in " and are treated as integers. String constants must \x 
entered in "" and are treated like "char *" (i e. pointer to char) Character and string constants 
may contain the standard backslashed escapes understood by the C compiler and the echo{l) 
conmiand, including "\b", "\f", "\n", "\r", "\t", "\\", "V", and "\nnn". However, ''\<new- 

line>" is not supported, neither in quotes nor fit the eir' -.'f ". f-«n:i:a;,.5 ]'.a-: 

Expressions are composed of any combination of variables, constants, and C oj)erators. If the 
debugger is invoked as cdb, the C operator "sizeof" is also available. If the debugger is invoked 
as fdb, FORTRAN operators are also available and FORTRAN meanuigs take precedence where 
there is a conflict. The same is true for Pascal if the debugger is invoked as pdb. 

If there is no active child process and no corefde, you can only evaluate expressions containing 
cuuistants. 

Expressions approximately follow the C rules of promotion, eg. char short, and int beco:ne 
long, and float becomes double. If either operand is a double, floating math is used. If either 
operand is unsigned, unsigned math is used. Otherwise, nc^nnal (integer) math is used. Results 
are then cast to proper destination types for assignments. 

If a floating point number is used with an operator that doesn't noriiially permit it, the niomfjer is 
cast to long and used that way. For example, the C binary o}>erator " " (bit invert) applied to 
the constant "3.14159" is the s-ame as " 3". 

Note that "=" means "assign" except for Pascal; use "==" or ' .EQ." for FORTRAN. In Pascal, 
" = " is a comparison operator; use ":=" for assigmnents. for exainple, if you Uivoke the debugger 
as cdb, then set "$lang = 2" (Pascal), you must say "Slang ;= " to return to C. 



Hewlett-Packard Company - 4 - Version B.l, October 1986 



CDB(l) HP-UX CDB{1) 

Series 200, 300, 500 Only 



Use "//' for division, instead of "/", to distinguish from display formatting (see Data Vievnnn 
Commands). 

Tlic special unary operator "Sin" (not to Ix; confused with debugger local variables) evaluates to 1 
(true) if the operand is an address inside a debuggable procedure and $pc (the current child pro- 
cess program location) is also in that procedure, else it is (false). For example, "Sin main" is 
true if the child process is stopped in rnain() 

If the nr'si expression on a ime beguis with -f- " or " ", use "()" around it to distinguish from the 
"+" and "- " conunands (see Data Viewing Commands). Parentheses may also be needed to dis- 
tinguish an ixpfsssiori iroiri ,i coiuiuaiia ii. liiouuies. 

You can attempt to dereference any constant, variable, or expression result using the C "*" opera- 
tor. If the address is invalid, ari error is given. 

Whenever an airay variable is referenced without giving all its subscripts, the result is the address 
of the icvy-est clement referenced. For example, consider an array declared as "x[5][6][7] " in C, 
"x(5,6,7/" in FOUTTLAN. or "^.',1 .5,2,.6,3..7j" in Pascal. Referencing it simply as "x" is the same 
<is just ":<" ni (J, the address of "xii,l,l)" in FORTRAN, or the address of "xfl,2,3]" in Pascal 
Referencing it as "x[4j" is the same as "h (x[4]f0][0l)" in C, the address of "x(l,l,4)" in FOR- 
TRAN, or the address of "x|4,2,3;" in Pf^cal. 

If a not- fully qualified array reference appears on the left side of an assignment, the value of the 
right-hai'.d expression iS stc^rtjd into the element at^ the address specified. 

Array indices are iK.'t chec.H.ed against declared h-(nmds. 

String constants ai'e stored m a magic Ijutfer in the file /usr/lih/end.o, which you link with your 
program. Tlie debugger siarts storing strings at the begirming of this buffer, and moves along as 
more assignments are made. !f the 'debugger reaches the end of the buffer, it goes back .and reuses 
it from t.l..e Ixigiuning In general this doesn't cause any problems. However, if you use very long 
strings, or if you assign a string constant to a global pointer, problems could arise. To fix them, 
yon can edit and compile a person,aI copy of /usr/Hb/end.c to increase the size of the buffer. 
(Some systems don't support thi,?; see the Hardware Dependencies section below.) 

Procedure Call Conventions 

Procedures may he invoked from tiie coniiiiand line, even within expressions. For examiple: 

xyz = $abc * (3 f def (ghi - i, jkl, "Hi Mom")) 

calls procedure "def" when its value is needed in the expression. 

An^ I rcokpo^nts * ^.^countere i aarmg commaiid line procedure invocation are handled as usual. 
Howe^tr i?t nevigg<.r h<is c>nl\ one r'tiVc con m uxd line at a time. If it stops in a called pro- 
cedure n»r aii> itciio. tne remainder ('* aiis ) of tUv o'd comm.and line is tossed, with notice given. 

If yt u atUmpt to call ^ p'-ocedun i\l en there is no active child process, one is started for you as if 

y n o-^xe . - i ^if s' sJ (. ^ " .. ^ . "1 L fi f" n n. i> this means that the data in corefilc (if any) 

: > ' < PjV ' , ^ . (I 

If }Ci acnd -. gT ri :)K .I\ 1 k y ^ f tfc nKF^J 5-1' ) while in a called procedure, the debugger 
c^o I c , . v^tdciit til tird ittu'iis lo mt '>rtvioii> --topping point (the start of the main pro- 
grai "< - .-' ew piO( e-^o) 

\i!i ^ ti „i\ yix td )n 1 -If ^ m \o ut^tcrtile even if it is not debuggable (was not com- 
l ied V -'h aeo'^g en F'r rxainplf, ass m-'e that y"u reference "printf()" in your program, so the 
code fc- It b 1 jOur i'_,r '\!i ri^f 30 i t,ii'' enter on the command line: 

;-- ^ ; Tn urk "<: '"( ^ 9 Ci, 

¥ I " '• <• * , ■■ ti i(" r \c' I It .'i 1 1 >t labels command ("1 1"). if you want tc 

hi^tr ■- ) J !i Hi^ 1 1 1 -. a\d fi' tor a<.Li'{''ng bat they aren't referenced anywhere in your 
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code (so they aren't linked), you can modify a personal copy of /usr/lih/end.c to reference them. 
(Some systems don't support this; see the Hardware Dependencies section below.) It is not 
necessary to have correct calls. For example, just "printf()" works fine, since you never execute 
the statements in end.c. 

Note that procedure name " end " is declared in end. c. 

COMMANDS 

The debugger has various commands for viewing and manipulating the program being debugged. 

File Viewing Commands 

These commands may chsmge the current viewing position, but they do not affect the next state- 
ment to be executed in the child process, if any. 

dir "directory" 

Add directory to the list of alternate source directories. Same as using -d invocation 
option. Main procedure file must reside in the current directory or be specified with the 
-d option. 

e Show the ctirrent file, procedure, line nimaber, and source line. 

e {Jile I proc) 

Enter (view) file or proc and print its first executable line. File can be any file, but 
must not be object code. 

[depth] E 

Like "e", but sets viewing location to the current location in proc on the stJick at depth 
depth (not necessarily the first executable line in the procedure). Default Depth is zero 
(where program is currently stopped). 

L This is a synonym for OE. 

line Print source line nmnber line in the current file. 

[line] p [counf] 

Print one (or count) lines starting at current line (or line number line). If multiple lines 
are printed, ciurent line is marked with "=" in leftmost colmnn. 

+ [lines] Move to lines (default one) lines after current line. 

-[/inea] Move to lines (default one) lines before current line. 

[line] w [size] 

Print window of text containing size (default 11) lines centered aroiind current line (or 
line). Target line is marked with "=" in leftmost column if multiple lines printed. 

[line] W [size] 

Same as "w", but size defaults to 21 lines. 

-|-w [size] 

-l-W [size] 

Print window of text of given or default size, beginning at end of previous window if the 
previous command was a window command; otherwise at current line. 

-w [size] 

-W [size] 

Print window of text of given or default size, ending at beginning of previous window if 
previous command was a window command; otherwise at current line. 

/[string] Search forward through the current file for string, starting at the line after the current 
line. 

? [sfrmff] Search backweird for string, starting with the line before the current line. 
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Searches wrap around the end or beginning of the file, respectively. If string is not specified, the 
previous one is used. Wild cards and regular expressions are not supported; string must be literal. 

n Repeat previous "/" or "?" command using same string as before. 

N The same as "n", but search goes in opposite direction from that specified by previous 

"/" or "?" command. 

Display Formats 

A format is of the form ''[*][count]formchar[size]" . Display formats apply only to Data Viewing 
Commands, described in the next sub-section. 

"*" means "use alternate address map" (if maps are supported). 

Count is the number of times to apply the format style formchar (must be a number). 

Size is the number of bytes to be formatted for each count (overrides the default size for the for- 
mat style); must be positive decimal number (except short hand notations). Size is disallowed 
with formchars where it makes no sense. 

For example, "abc/4x2" prints, starting at the location of "abc", four two-byte ntmibers in hexa- 
decimal. 

The formats which print numbers allow an upper-case character to be used instead, for the same 
results as appending "1" (see below). For example, "O" prints in long octal. These formats, 
which are useful on systems where integer is shorter than long, are noted below. The following 
formats are available: 

n Print in the "normal" format, based on the type. Arrays of char and pointers to 

char are interpreted as strings, and structures are fully diunped. 

(d I D) Print in decimal (as integer or long). 

(u I U) Print in unsigned decimal (as integer or long). 

(o I O) Print in octal (as integer or long). 

(x I X) Print in hexadecimal (as integer or long). 

(b I B) Print a byte in decimal (either way). 

(c I C) Print a character (either way). 

(e I E) Print in "e" floating point notation (as float or double) (see prm</(3S)). 

Remember that floating point constants are always doubles! 

(f I F) Print in "f" floating point notation (as float or double). 

(g I G) Print in "g" floating point notation (as float or double). 

a Print a string using expr as the address of the first byte. 

s Print a string using expr as the address of a pointer to the first byte (same as 

"*expr/a", except for arrays). 

t Show the type of expr (usually a variable or procedure name). For true pro- 

cediure types you must actually call the procedure, e.g. "def(arg)/t". 

p Print the name of the procediu-e containing address expr. 

S Do a formatted dump of a structure, expr must be the address of a structure, not 

the address of a pointer to a structure. 

There are some short hand notations for size: 

h 1 byte (char). 
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s 2 bytes (short). 

1 4 bytes (long). 

These can be appended to formchar instead of a numeric size. For example, "abc/xb" prints one 
byte in hexadecimal. 

If you view an object with a size (explicitly or imphcitly) less than or equal to the size of a long, 
the debugger changes the basetype to something appropriate for that size. This is so "." (dot) 
works correctly for assignments. For example, "abc/c2" sets the type of "." to short. One side 
effect is that if you look at a double using a float format, dot loses accuracy or has the wrong 
value. 

Data Viewing Commands 

expr If expr does not resemble anything else (such as a command), it is handled as "expr/n" 
(print expression in normal format), unless followed by ";" or "}", in which case nothing 
is printed. 

expr /format 

Print the contents (value) of expr using format. 

exprlformat 

Print the address of expr using format. 

'[[/]format] 

Back up to the preceding memory location (based on the size of the last thing displayed). 
Use format if supplied, or the previous format if not. No "/" is needed after the "*". To 
reverse direction again (e.g. start going forward), enter "." {dot) (always an alias for the 
current location) followed by carriage return. 

1 [proc[.depf/i]] 

List all parameters and local variables for current procedm-e (or proc, if given, at the 
specified depth, if any). Data display uses "/n" format, except arrays and pointers are 
shown as addresses; only the first word of a structure is shown. 

1 (a I b I d I z) 

List all assertions, breakpoints, directories (where to search for files), or zignals (signal 
actions). 

1 (f I g I 1 I p I r I s) [string] 

List all files (source files which built objectfile), globsd variables, labels (program entry 
points known to the linker), procedure names, registers, or special variables (except regis- 
ters). If string is present, only those things with the same initial characters are listed. 

Stack Viewing Conunands 

[depth] t Trace the stack for the first depth (default 20) levels. 

[depth] T The same as "t", but local variables are also displayed using "/n" format 

(except that arrays and pointers are shown as addresses; structures show first 
word only). 

Job Control Commands 

The parent (debugger) and child {objectfile) processes take turns running. The debugger is only 
active while the child process is stopped due to a signal (includes hitting a breakpoint) or ter- 
minated for whatever reason. 

r [arguments] 

Rim a new child process with given argument list, if any (an existing child process is 
terminated first). If no arguments are given, those used with the last "r" command are 
used again (none if "R" was used last). 
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Arguments may contain "<' and ">' for redirecting standard input and standard out- 
put. ("<" does an open(2) of file descriptor for read-only; ">" does a creat{2) of file 
descriptor 1 with mode 0666; "»" is not supported.) Arguments may contain shell 
variables, quote marks, or other special syntax (expanded by Boiune shell). "{}" are 
shell metacharacters, so 'r' cannot be safely saved in a breakpoint or assertion com- 
mand list. 

R Run a new child process with no argument list. 

k Terminate (kill) the ciurent child process, if any. 

[count] c [line] 

Continue after a breakpoint or a signal, ignoring the signal, if any. If count is given, the 
current breakpoint, if any, has its count set to that value. If line is given, a temporary 
breakpoint is set at that line number, with a count of -1 (see Breakpoint Com- 
mands). 

[count] C [line] 

Continue like "c", but allow the signal (if any) to be received. 

[count] s Single step 1 (or count) statements (successive carriage-retiums repeat with a count of 
1). If count is less than one, the child process is not stepped. The child process contin- 
ues with the current signal, if any (set "Ssignal = 0" to prevent). 

[count] S 

Single step like "s", but treat procediure calls as single statements (don't follow them 
down). If a breakpoint is hit in such a procedure, or in one that it calls, its commands 
are executed. (This is usually all right imless there is a "c" command in that 
breakpoint's command list.) 

The debugger has no knowledge about or control over child processes forked in turn by the pro- 
cess being debugged. Programs being debugged should not execute a different program via 
ca:ec(2). 

Child process output may be buffered, so it may not appear immediately after you step through 
an output statement such as prtnt/(3S). It may not appear at all if you kill the process. 

Breakpoint Commands 

A breakpoint has three attributes associated with it: 

address All the commands which set a breakpoint are simply alternate ways to specify 

the breakpoint address. The breakpoint is encountered whenever address is 
about to be executed, regardless of the path taken to get there. Only one break- 
point at a time (of any type or count) may be set at a given address. Setting a 
new breakpoint at address replaces the old one, if any. 

count The munber of times the breakpoint is encountered prior to recognition. If count 

is positive, the breakpoint is "permanent", and count decrements with each 
encounter. Each time count goes to zero, the breakpoint is recognized and count 
is reset to one (so it stays there until explicitly set to a different value by "c" or 
"C"). 

If count is negative, the breakpoint is "temporary", and count increments with 
each encounter. Once count goes to zero, the breakpoint is recognized, then 
deleted. 

commands Actions to be taken upon recognition of a breakpoint before waiting for com- 

mand input. These are separated by ";" and may be enclosed in "{}" to delimit 
the list saved with the breakpoint from other commands on the same line. 
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Results of expressions followed by ";" or "}" are not printed unless you specify a 
print format. 

Saved commands are not parsed until the breakpoint is recognized. If there are 
no commands, the debugger will wait for command input when the breakpoint is 
recognized. For immediate continuation, finish the command list with "c". 

Breakpoint commands: 

1 b 

B Both forms list all breakpoints in the format: 

num: count: nnn proc: In: contents 
{commands} 

The leftmost number num is an index nmnber for use with the "d" (delete) command. 

[line] b [commands] 

Set a permanent breakpoint at the cmrent line (or at line in the current procedure). 

[expr] d 

Delete breeikpoint number expr. If expr is absent, delete the breakpoint at the current 
line, if any. If there is none, the debugger executes a "B" command instead. 

bp [commands] 

Set permanent breakpoints at the beginning (first executable line) of every debuggable 
procedure. When any procedure breakpoint is hit, commands are executed. 

D [b] Delete all breakpoints (including "procedure" breakpoints). The "b" is optional. 

D p Delete all "procedure" breakpoints. All breakpoints set by commands other than "bp" 
remain set. 

For the following commands, if the second character is upper case, for example, "bU" instead of 
"bu", the breakpoint is temporary (count is -1), not permanent {count is 1). 

[depth] bb [commands] 

[depth] bB [commands] 

Set a breakpoint at the beginning (first executable line) of the procedure at the specified 
stack depth. If depth is not specified, use the current procedure (may not be the same as 
the one at depth zero). 

[depth] bx [commands] 

[depth] bX [commands] 

Set a breakpoint at the exit (last executable line) of the procedure at the given stack 
depth. If depth is not specified, use the current procedure (may not be the same as the 
one at depth zero). The breakpoint is set such that all returns of any kind go through it. 

[depth] bu [commands] 

[depth] bU [commands] 

Set an up-level breakpoint. The breakpoint is set immediately after the return to the pro- 
cedure at the specified steick depth (default one, not zero). Zero depth means "current 
location". 

[depth] bt [proc] [commands] 

[depth] bT [proc] [commands] 

Trace current procedure (or procedure at depth, or proc). Set bresikpoints at entrance 
and exit of a procedure. Default entry breakpoint commands are "Q;2t;c" (show top two 
procedures on stack and continue). The exit breakpoint always executes "Q;L;c" (print 
current location and continue). 
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If depth is given, proc must be absent or it is taken as part of commands. If depth is 
missing but proc is specified, the neuned procedure is traced. If both depth and proc are 
omitted, the current procedure is traced, which might not be the same as the one at depth 
zero. 

If commands are present, they are used for the entrance breakpoint, instead of the default 
shown above. 

address ba [commands] 

address bA [commands] 

Set a breakpoint at the given code address, address can be the name of a procedure or an 
expression containing such a name. If the child process is stopped in a non-debuggable 
procedure, or in prologue code (before the first executable line of a procedure), results 
may seem a little strange. 

The next few commands are not strictly part of the breakpoint group, but are used almost 
exclusively as arguments to breakpoints (or assertions). 

if [eipr] {commands} [{commands}] 

If expr evaluates to a non-zero value, the first group of commands (the first "{}" block) is 
executed, otherwise it (and the following "{", if any) is skipped. AH other "{}" blocks 
are always ignored (skipped), except when given as an argument to an "a", "b", or "!" 
conunand. The "if" command is nestable, and can be abbreviated to "i". 

Q If the "quiet" command appears as the first command in a breakpoint's command list, the 

normal announcement of "proc: line: text" is not made. This allows quiet checks of vari- 
ables, etc. to be made without cluttering up the screen with unwanted output. The "Q" 
command is ignored if it appears ansrwhere else. 

"any string you like" 

Print the given string. String may contain standard backslashed character escapes, 
including "\n" for newline. Useful for labelling output from breakpoint commands. 

Assertion Control Commands 

Assertions are command lists that are executed before every statement. Thus, if there is even one 
active assertion, the program is single stepped at the machine instruction level (runs very slowly). 
They are primarily used for tracking down nasty bugs (such as the corruption of a global vari- 
able). 

Assertions C£in be activated or suspended individually, plus there is an overall mode. 

a commands 

Create new assertion with given conmiand list. List is not parsed until execution time. 
Command list can be enclosed in "{}" to delimit it from other commands on the same 
line. The "1 a" command lists all current assertions and the overall mode. 

expr a (a I d I s) 

Modify the assertion numbered expr. activate it, delete it, or suspend it. Suspended 
assertions continue to exist, but do nothing imtil reactivated. 

A Toggle the overall state of the assertions mechanism between active and suspended. 

D a Delete all assertions. 

[flag] X Force exit from assertions mode. If flag is absent or evaluates to zero, exit inunediately. 
Otherwise, finish executing the current assertion first. If an assertion executes an "x" 
command, the child process stops and the assertion doing the "x" is identified. 

The debugger has only one active command line at a time. The current command line is dis- 
carded when assertion execution begins. 
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Commands "r", "R", "c", "C", "s", "S", and 'k" are not allowed while assertions are running. 
They must appear after the "x", if at all. 

Signal Control Commands 

The debugger catches all signals bound for a child process before the child process sees them (a 
fmiction of the ptrace{2) mechanism). 

[signal] z \\][t]\b]\Q] 

Maintains the "zignal" (signal) handling table. Signal is a valid signal number (default is 
the current signal). The options (which must be all one word) toggle the state of the 
appropriate flag: ignore, report, or stop. If "Q" is present, the new signal state is not 
printed. 

"1 z" lists the current handling of all signals, 'z" (with no options) shows the state of the 
current or selected signal. 

For example, assimiing a start up state of (don't ignore, don't report, don't stop), the command 
"lAx sr" sets the alarm clock signal to stop (but still don't ignore) and report that it occurred. 
Doing ''14z sr" again toggles the flags back to the original state. 

When the child process stops or terminates on a signal it is always reported, except for the break- 
point signal when the breakpoint conunands start with "Q". 

When the debugger ignores a signal, the "c" command does not know about it. A signal is never 
ignored when the child process terminates, only when it stops. 

Record and Playback Commands 

The debugger supports a record/playback feattire to help recreate program states and to record all 
debugger output. 

Commands are: 

>file Set or change recordfile to file and turn recording on. This rewrites file from the start. 
Only commands are recorded to this file. 

»file Same as »file but appends to file instead of overwriting. 

>@/»7e 

»@/t7eSet or change record-all file to file, for overwriting or appending. The record-all file can 
be opened or closed independent of the recordfile. All debugger standard output is copied 
to the record-all file, including prompts, commands entered, and command output (does 
not capture child process output). 

>(t I f I c) 

Turn recording on ("t') or off ("f"), or close the recording file ("c"). When recording is 
resumed, new commands are appended to previous file contents. In this context, ">>" is 
equivalent to ">". 

>@(t I Ttra) record-all on, off, or close the record-all file. In this context, ">>@" is equivalent 
to '>©'. 

> Tell the current recording status (same as ">>"). 

>@ Tell the current record-all status (same as ">>@"). 

<file Start playback from file. 

«file Start playback from file, using the single-step featmre of playback. 

Only command lines read from the keyboard or a playback file are recorded in the recordfile. 

Command lines beginning with ">", "<", or "l" are not copied to the current recordfile (they are 
copied to the record-all file). To override this, begin such lines with blanks. 



Hewlett-Packard Company - 12 - Version B.l, October 1986 



CDB(l) HP-UX CDB(l) 

Series 300, 300, 500 Only 



NOTE: The debugger can be invoked with standard input, stwidard output, and/or standard 
error redirected, independent of record and playback. If the debugger encounters an end-of-file 
while standard input is redirected from anything other than a terminal, it prints a message to 
standard output and exits, returning zero. 

Miscellaneous Commands 

<carriage-retum> 

An empty line or a " ' command causes the debugger to repeat the last command, if pos- 
sible, with an appropriate increment, if any. Repeatable commands are those which print 
a line, print a window of lines, print a data value, single step, and single step over pro- 
cedures. <carriage-retum> is saved in a record file as a " " command, to distinguish 
from 'D. 

*D Control-D is like <carriage-retum>, but repeats the previous command ten times. This 
command is saved in a record file as an empty line. 

! [command-line] 

This shell escape invokes a shell program. If command-line is present, it is executed via 
syatem{3S). Otherwise, the environment variable SHELL gives the name of the shell pro- 
gram to invoke with a -i option, also using 8y8tem{3S). If SHELL is not foimd, the 
debugger executes "/bin/sh -i". In any case, the debugger then waits for the shell or 
command-line to complete. 

As with breakpoints, command-line may be enclosed in "{}" to delimit it from other 
(debugger) commands on the same line. For example, 

14b {!{date};c}; t; I a 

sets a breakpoint at line 14 that calls date{l), then continues; then (after setting the 
breakpoint), the debugger does a stack trace, then lists assertions. 

f [" printf-atyle-format'] 

Set address printing format, using printf(3S) format specifications (not debugger format 
styles). Only the first 19 characters are used. If there is no argiunent, the format is set 
to a system-dependent default. All addresses are assumed to be of type long, so you 
should handle all four bytes to get something meaningful. 

F Find and fix bug (a useless but humorous command). 

g line Go to an address in the procedure on the stack at depth zero (not necessarily the current 
procedure). Changes the program counter so line is the next line to be executed. 

h 

help Print the debugger help file (command sunmiary) using more(l). 

I Print information (inquire) about the state of the debugger. 

M Print the current text {objectfile) and core (corefile) address maps. 

M (t I c) [expr; [expr,...]] 

Set the text (objectfile) or core (corefile) address map. The first zero to six map values 
are set to the exprs given. 

q Quit the debugger. Requests confirmation. 

Z Toggle case sensitivity in searches. This affects everjrthing: File names, procediure names, 

variables, and string searches! The debugger starts out as not case sensitive. 

HARDWARE DEPENDENCIES 

The "bx" (break on exit) command requires that compilers support it by funneling all exits 
through one point. The breakpoint is always set at the last line of the procedure, which should 
be, but may not be, the sole exit point. 



Hewlett-Packard Company - 13 - Version B.l, October 1986 



CDB(l) HP-UX CDB(l) 

Series 200, 300, 500 Only 



Series 300, 500 

When a C parameter is declared as an array of anything, the highest type qualifier (array) 
shows up as a pointer instead. For example, "Lnt x[]" looks like "int *x", and "char (*x)[]'' 
looks like "char **x", but "char *x[]" is treated correctly as "pointer to array of char". 

There is limited support for command-line calls of functions which retiun structures. The 
debugger interprets the start of heap as a structure of the return type. However, a call such 
as "abc()/t" displays the return type correctly. 

$short and $long are available in addition to $result. If command-line procedure call 
returns a double, $result is set to the value cast to long. 

The source file end.c is not supported, so you can't customize /usr/Ub/end.o. The buffer 
size is fixed at 200 bytes. To force linking of library routines not otherwise referenced, use 
the -u option to ld{l). 

Procedures in FORTRAN and Pascal may have alias names in addition to normal names. 
Aliases are shown by the "1 p" (list procedures) command. They can be used in place of 
the normal name, as desired. 

The procedm-e name "_MAIN_" is used as the ahas name for the main program (main pro- 
cedure) in all supported languages. Do not use it for any debuggable procedures. 

FORTRAN ENTRY points are flagged "ENTRY" by the "1 p" command. 

When a compiler does not know array dimensions, such as for some C and FORTRAN array 
parameters, it uses 0:MAXINT or 1:MAXINT, as appropriate. The "/t" format shows such 
cases with "[]" (no boimds specified), and subscripts from (or 1) to MAXINT are allowed in 
expressions. 

There is no support for: C structure, vmion, and emuneration tags, C typedefs, and Pascal 
types. 

Some vjiriables are indirect, so a child process must exist in order for the debugger to know 
their addresses. When there is no child process, the address of any such variable is shown as 
Oxfffffffe. 

The optional pattern given with the "1 g" (list globeils) command must be £in exact match, 
not just a leading pattern. 

Symbol names in the Value Table are never preceded by underscores, so the debugger never 
bothers to search for names of that form. The only time a prefixed imderscore is expected is 
when searching the Linker Symbol Table for names of non-debuggable procedures. 

Series 300 

Series 300 supports two types of string formats in addition to null-terminated C strings. 
FORTRAN character variables consist of a string of bytes (no null terminator). Pascal string 
variables consist of a length byte, followed by the string characters. The "\s" and "\a" for- 
mats will display these types correctly, only if the current language is FORTRAN or Pascal. 

Series 500 

"bx" works, except for FORTRAN multiple returns. The compilers emit a special soiu-ce line 
symbol for this exit point, after the last "visible" source line. 

Series 500 supports two types of string formats in addition to null-terminated C strings. 
FORTRAN character variables consist of fomr-word (16-byte) string markers, where the 
second word plus the third word plus three is the byte address of the string itself, and the 
fourth word is the length of the string. Pascal string variables consist of a four-byte, 
word-aligned length word followed by the string characters. 
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If the current language is FORTRAN, or if you use "/s" format with fdb or pdb, the 
debugger interprets the variable (or expression) as a string marker (or address thereof), 
which is a null pointer if the second word of the marker is zero. Multiple-count formats 
show a series of fixed-length strings, beginning with the first one pointed to by the marker. 
Using "<cr>" or """ to go forward or backward in memory uses the four words after or 
before the current string marker as the new marker. 

If the current language is Pascal, or if you use "/a" format with fdb or pdb, the debugger 
interprets the variable (or expression) as a Pascal string (or address thereof). Multiple- 
coimt formats show a series of random-length strings, using successive length words, skip- 
ping any wasted bytes in the last word of the previous string. Likewise, using "<cr>" or 
" " " to go through memory skips the total bytes consumed in the last display. 

There is no easy way to assign into a FORTRAN or Pascal string (nor, for that matter, into 
a Pascal packed array of char, which looks like a simple array). Only one word is copied 
into the first word of the string marker or into the length word, regardless of the type of the 
expression result. 

There £ire no address maps in the usual sense, so the "M" command is not supported. 

If a child process receives a signal and you then step with the "s" command (or run with 
assertions active), the process free-runs through the signal handler procediure (if any) before 
pausing (or doing assertions). 

Code and data pointers in objectfile both contain segment numbers. At exec{2) time, all 
such pointers are mapped from ld{l) pseudo-values to real values based on actual segment 
numbers allocated. The debugger operates in "pseudo-address-space", so you won't notice 
anything imusual most of the time. All addresses look the same each time you invoke a new 
child process. For ex£imple, the heap always begins at "broken" address zero (0). 

WARNING: The debugger's interaction with a child process is somewhat complicated, due 
to the "fixing" of pointer values written to the child and the "breaking" of pointers read 
from the child. If you tell the debugger to treat a pointer as a non-pointer, it may get con- 
fused, with impredictable results. In particular, if you set a debugger special variable equal 
to a pointer value, then attempt to dereference that special variable, you will either get gar- 
bage or cause an access error. 

In the rare case where maxheap is set very large (greater than 70Mb) and your program 
uses shared EMS segments (from mema//c(2)), the debugger may confuse pointers into the 
EMS segments with large addresses in the heap. 

Addresses of imknown (non-debuggable) procedures are shown as call-type pointers, not 
data pointers. They can be distinguished because the high bit is set (e.g., the decimal value 
looks negative). Pointers of this form are not usable for anything; you can't dereference 
them nor set breakpoints based on them. 



FILES 



a.out Default objectfile to debug, 

core Default corefile to debug, 

/usr/lib/cdb.help Text file listed by the "help" command, 
/usr/lib/cdb.error Text file which explains debugger 

error and warning messages, 
/usr/lib/end.o Object file to link with all debuggable 

programs. 

AUTHOR 

Cdb was developed by Third Eye Software. 
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SEE ALSO 

cc(l), echo(l), fc(l), pc(l), ld(l), more(l), creat(2), exec(2), fork(2), open(2), 8etjmp(3C), 
printf(3S), 8y8tem(3S), a.out(4), and the cdb Debugger tutorial in HP-UX Concepts and Tutorials. 

On some systems any of the following may exist: adb(l), ptrace(2), core(4). 

DIAGNOSTICS 

Most errors cause a reasonably accxu-ate message to be given. Normal debugger exits return zero 
and error exits return one. All debugger output goes to standard output except error messages 
given just before non-zero exits, which go to standard error. 

Debugger errors are preceded by "panic: ", while user errors are not. If any error occurs during 
initialization, the debugger then prints "cannot continue" and quits. If any error happens after 
initialization, the debugger attempts to reset itself to an idle state, waiting for command input. If 
any error occurs while executing a procedure call from the command line, the context is reset to 
that of the normal program. 

Child process (program) errors result in signals which are communicated to the debugger via the 
ptrace{2) mechanism. If a program error occurs while executing a procedure call from the com- 
mand line, it is handled like any other error (i.e. you can investigate the called procedure). To 
recover from this, or to abort a procedure call from the command line, type DEL, BREAK, 'C, or 
whatever your interrupt character is. 

For more information, see the text file /usr/lib/cdb.errors. 

WARNINGS 

Code that is not debuggable or does not have a corresponding source file is dealt with in a half- 
hearted manner. The debugger shows "unknown" for unknown file and procedure names, cannot 
show code locations or interpret parameter lists, etc. However, the linker symbol table provides 
procedure names for most procedures, even if not debuggable. The main procedure (main pro- 
gram) must be debuggable and have a corresponding source file. 

If the address given to a "ba" command is a not a code address in the child process, strange 
results or errors may ensue. 

If you set the address printing format to something printf{iS) doesn't like, you may get an error 
(usually memory fault) each time you try to print an address, until you fix the format with 
another "f" command. 

Do not use the "z" command to manipulate the SIGTRAP signal. ,If you change its state you had 
better know what you are doing or be a very good sport! 

If you single step or run with assertions through a call to longjmp{iC), the child process will 
probably take off free-nmning as the debugger sets but never hits an up-level breakpoint. 

Do not modify any file while the debugger has it open. If you do, the debugger gets confused and 
may display garbage. 

Although the debugger tries to do things reasonably, it is possible to confuse the recording 
mechanism. Be careful about trying to playback from a file currently open for recording, or vice 
versa; strange things can happen. 

Many compilers only issue source line symbols at the end of each logical statement or physical 
line, whichever is greater. This means that, if you are in the habit of saying "a = 0; b = 1;" on 
one line, there is no way to put a breakpoint after the assignment to "a" but before the assign- 
ment to "b". 

Some statements do not emit code where you would expect it. For example, assmne: 



99 
100 
101 



for (i = 0; i < 9; i++) { 

xyz (i); 
} 
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A breakpoint placed on line 99 will be hit only once in some cases. The code for incrementing is 
placed at line 101. Each compiler is a little different; you must get used to what your particular 
compiler does. A good way of finding out is to use single stepping to see in what order the soiure 
lines are executed. 

The output of some program generators, such as yace{l), have compiler line number directives in 
them that can confuse the debugger. It expects source line entries in the symbol table to appear 
in sorted order. Removal of line directives fixes the problem, but makes it more difficult to find 
error locations in the original source file. The following script, nm after yacc(l) and before cc(l), 
comments out line number changes in C programs: 

sed "/# *line/s/*.*$/\/*&*\//'' y.tab.c >temp.c 

yacc{l) will leave out line directives if invoked with the -1 option. In general, line number direc- 
tives (or compiler options) are only safe so long as they never set the number backwards. 



BUGS 



The C operators "++", " — ", and "?:" are not available. The debugger always imderstands all 
the other C operators, except "aizeof, if the default language is FORTRAN or Pascal. 

For FORTRAN, only the additional operators ".NE.", ".EQ.", ".LT.", ".LE.", ".GT.", and 
".GE." are supported. 

For Pascal, only the operators ":=", "<>", "*', "*." (as in "x'.y"), "and", "or", "not", "div", 
"mod", "addr", and "sizeof" are added. 

There is no support for FORTRAN complex variables, except as a series of two separate floats or 
doubles. 

The debugger doesn't understand C tyi)e casts. 

The C operators "je&" and "11" aren't short circuit evaluated as in the compiler. All parts of 
expressions involving them are evaluated, with any side-effects, even if it's not necessary. 

The debugger doesn't imderstand C pointer arithmetic. "*{&+n)" is not the same as "a[n]" imless 
"a" has an element size of 1. 

There is no support for C local variables declared in nested blocks, nor for any local overriding a 
parameter with the same name. When looking up a local by name, parameters come first, then 
locals in the order of the "}"s of the blocks in which they are declared. When listing all locals, 
they are shown in the same order. When there is a name overlap, the address or data shown is 
that of the first variable with that name. 

CDB does not support identically-named procedures (legal in Pascal if the procedures are in 
different scopes). CDB will always use the first procedure with the given name. 

There is no support for Pascal packed arrays where the element size is not a whole number of 
bytes. Any reference into such an array may produce garbage or a bad access. 

Pascal WITH statements are not imderstood. To access any variable you must specify the com- 
plete "path" to it. 

The debugger supports call-by-reference only for known parameters of known (debuggable) pro- 
cedures. If the object to pass lives in the child process, you can fake such a call by passing "& 
object", i.e. the address of the object. 

Array parameters are always passed to command-line procedure calls by address. This is correct 
except for Pascal call-by-value parameters. Structiure parameters are passed by address or value, 
as appropriate, but only a maximum of eight bytes is passed, which can totally confuse the called 
procedure. Series 500 FORTRAN string markers are never passed correctly. Only the first 
number of a complex pair is passed as a parameter. Fimctions which return complex niunbers are 
are not called correctly; insufficient stack space is allocated for the return area, which can lead to 
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overwriting the parameter values. 

Assignments into objects greater than four bytes in size, from debugger special variables, result in 
errors or invalid results. 

Command lines longer than 1024 bytes are broken into pieces of that size. This may be relevant 
if you nm the debugger with playback or with input redirected from a file. 

DVTERNATIONAL SUPPORT 

cdb: 8-bit filenames, messages. 



Hewlett-Packard Company - 18 - Version B.l, October 1986 



CDC(l) 



HP-UX 



CDC(l) 



NAME 

cdc - change the delta commentary of an SCCS delta 

SYNOPSIS 

cdc -rSID [-in[mrlist]] [-y[comment]] files 

DESCRIPTION 

Cdc changes the delta commentary, for the SID specified by the -r keyletter, of each named SCCS 
file. 

Delta commentary is defined to be the Modification Request (MR) and comment information nor- 
mally specified via the delta{\) command (-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in the directory were specified as a named 
file, except that non-SCCS files (last component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of - is given, the standard input is read (see 
WARNINGS); each line of the standard input is taken to be the name of an SCCS file to be pro- 
cessed. 

Argimients to cdc, which may appear in any order, consist of keyletter arguments and file names. 

All the described keyletter arguments apply independently to each named file: 

-tSID Used to specify the 5CCS /ZJentification (SID) string of a delta for which 

the delta commentary is to be changed. 

-m.[mrlisi\ If the SCCS file has the v flag set (see odmm(l)) then a list of MR numbers 

to be added and/or deleted in the delta commentary of the SID specified 
by the -r keyletter may be supplied. A null MR list has no eflFect. 

MR entries are added to the list of MRs in the same manner as that of 
delta{l). In order to delete an MR, precede the MR number with the 
character ! (see EXAMPLES). If the MR to be deleted is ciurently in the 
list of MRs, it is removed and changed into a "comment" line. A list of all 
deleted MRs is placed in the comment section of the delta commentary and 
preceded by a comment line stating that they were deleted. 

If -m is not used and the standard input is a terminal, the prompt MRs? 
is issued on the standard output before the standard input is read; if the 
standard input is not a terminal, no prompt is issued. The MRs? prompt 
always precedes the comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. An unes- 
caped new-line character terminates the MR list. 

Note that if the v flag has a value (see admin{l)), it is taken to be the 
name of a program (or shell procedure) which validates the correctness of 
the MR numbers. If a non-zero exit status is returned from the MR 
nxmiber validation program, cdc terminates and the delta commentary 
remains unchanged. 

-y[comment\ Arbitrary text used to replace the comment{s) already existing for the 
delta specified by the -r keyletter. The previous comments are kept and 
preceded by a comment line stating that they were changed. A null com- 
ment has no effect. 

If -y is not specified and the standard input is a terminal, the prompt 
comments? is issued on the standard output before the standard input is 
read; if the standard input is not a terminal, no prompt is issued. An unes- 
caped new-line charsicter terminates the comment text. 
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The exact permissions necessary to modify the SCCS file are docimiented in the Source Code 
Control System User Guide. Simply stated, they are either (1) if you made the delta, you 
can change its delta commentary; or (2) if you own the file and directory you can modify the 
delta commentary. 

EXAMPLES 

cdc -rl.6 -m"bl78-12345 !bl77-54321 bl79-00001" -ytrouble 8.file 

adds bl78-12345 and bl79-00001 to the MR list, removes bl77-54321 from the MR list, and adds 
the comment trouble to delta 1.6 of s.file. 

cdc -rl.6 s.file 

MRS? !bl77-54321 bl78-12345 bl79-00001 

comments? trouble 



FILES 



does the same thing. 

x-file (see delta{l)) 

z-file (see delta{l)) 



SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(4). 

Source Code Control System User Guide in the HP-UX Concepts and Tutorials. 

DIAGNOSTICS 

Use help{l) for explanations. 

WARNINGS 

If SCCS file names are supplied to the cdc command via the standard input (- on the commsmd 
line), then the -m and -y keyletters must also be used. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

cfiow - generate C now graph 

SYNOPSIS 

cflow [-r] [-ix] [-i_ ] [-dnum] files 

DESCRIPTION 

Cflow analyzes a collection of C, YACG, LEX, assembler, and object files and attempts to build a 
graph charting the external references. Files suffixed in .y, .1, .c, and .i are YACC'd, LEX'd, and 
C-preprocessed (bypassed for .i files) as appropriate and then nm through the first pass of lint{l). 
(The -I, -D, and -U options of the C-preprocessor are also understood.) Files suffixed with .s 
are assembled and information is extracted (as in .o files) from the symbol table. The output of 
all this non-trivial processing is collected and turned into a graph of external references which is 
displayed upon the standard output. 

Each line of output begins with a reference (i.e., line) nmnber, followed by a suitable munber of 
tabs indicating the level. Then the name of the global (normally only a function not defined as an 
external or begirming with an underscore; see below for the -i inclusion option) a colon and its 
definition. For information extracted from C soiu-ce, the definition consists of an abstract type 
declaration (e.g., char *), and, delimited by angle brackets, the name of the soiurce file and the 
line nmnber where the definition was foimd. Definitions extracted from object files indicate the 
file name and location coimter imder which the symbol appeared (e.g., text). Leading imderscores 
in C-style external names are deleted. 

Once a definition of a name has been printed, subsequent references to that name contain only the 
reference nmnber of the line where the definition may be found. For imdefined references, only 
<> is printed. 

As an example, given the following in file.c: 
int i; 



main() 




{ 
} 


f(); 
g(); 
f(); 


f() 
{ 

} 


i = M); 


the command 




cflow - 


ix file.c 


produces the output 


1 


main: int(), <file.c 4> 


2 


f: into, <file.c 11> 


3 


h:<> 


4 


i: int, <file.c 1> 


5 


g:<> 
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When the nesting level becomes too deep, the -e option of pr(l) can be used to compress the tab 
expansion to something less than every eight spaces. 

The following options are interpreted by cflow: 

—T Reverse the "caller:callee" relationship producing an inverted listing showing the 

callers of each function. The listing is also sorted in lexicographical order by cal- 
lee. 

-ix Include external and static data symbols. The default is to include only functions 

in the flowgraph. 

-i Include names that begin with an imderscore. The default is to exclude these 

functions (and data if -ta: is used). 

-dnimi The num decimal integer indicates the depth at which the flowgraph is cut off. 

By default this is a very large number. Attempts to set the cutoff depth to a 
nonpositive integer will be met with contempt. 

DIAGNOSTICS 

Complains about bad options. Complains about multiple definitions and only believes the first. 
Other messages may come from the various programs used (e.g., the C-preprocessor). 

HARDWARE DEPENDENCIES 

Series 200, 300, 500 

The following option is supported: 

-Y Enable support of 16-bit characters inside string literals and comments. Note that 8-bit 
parsing is always supported. See /ipnfa(5) for more details on International Support. 

SEE ALSO 

as(l), cc(l), cpp(l), lex(l), lint(l), nm(l), pr(l), yacc(l). 

BUGS 

Files produced by lex{l) and j/acc(l) cause the reordering of line number declarations which can 
confuse cflow. To get proper results, feed cflow the yacc or lex input. 
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NAMB 

chatr - change program's internal attributes 

SYNOPSIS 

chatr [-n] [-q] [-s] files 

Remarlcs: 

This manual page describes chatr as implemented on Series 200 computers. Refer to other 
chatr{l) manual pages for information valid for other implementations. 

DESCRIPTION 

Chatr, by default, prints each filers magic munber and file attributes to the standard output. 
With one or more optional arguments, chatr performs the following operations: 

-n change the file from demand loaded to shared. 

-q change the file from shared to demand loaded. 

-8 perform action silently. 

Upon completion, chatr prints the file's old and new values to the standard output file, imless -s 
is in effect. 

RETURN VALUE 

Chatr returns zero on success. If the call to chatr is syntactically mcorrect, or one or more of the 
specified files cannot be acted upon, chatr retiums the munber of files whose attributes could not 
be modified. If no files are specified, chatr returns decimal 255. 

SEE ALSO 

ld(l), a.out(5), magic(5). 

DIAGNOSTICS 

The error messages produced by chatr should be self-explanatory. 
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NAME 

chatr - change program's internal attributes 

SYNOPSIS 

/Ibln/chatr [+c|-c] [+g|-g] [+h|-h] [-mn] [+n|-n] [+pl-p] [-ql-Q] [-s] [+z|-ii] file 

Remarks: 

This manual page describes chatr as implemented on Series 500 computers. Refer to other 
chatr {1) manual pages for information valid for other implementations. 

DESCRIPTION 

Chatr, by default, prints each file's magic niunber and file attributes to the standard output. 
With one or more optional argtmients, chatr performs the following operations: 

c set (+) or clear (-) the virtual bit for each code segment. 

g set (+) or clear (-) the virtual bit of the global data segment. 

h set (+) or clear (-) the virtual bit for the heap of a two data segment program. 

-mn change the maximiun heap size to n bytes. 

n mark code as shareable (+) (magic number = SHARE__MAGIC), or tmshareable (-) 

(magic number = EXEC_MAGIC). 

p set (+) or clear (-) the paged and virtual bits for the heap of a two data segment pro- 

gram. 

-q set the demand load bit for each segment. 

-Q clear the demand load bit for each segment. 

-s perform action silently. 

-wn change the maximiun working set size to n bytes. 

z set (-I-) or clear (-) the demand load bit for each segment. 

Upon completion, chatr prints the file's old and new values to the standard output file, imless -s 
is in effect. 

RETURN VALUE 

Chatr returns zero on success. If the call to chatr is syntactically incorrect, or one or more of the 
specified files cannot be acted upon, chatr returns the number of files whose attributes could not 
be modified. If no files are specified, chatr returns decimal 255. 

SEE ALSO 

ld(l), a.out(5), magic(5). 



Hewlett-Packard Company - 1 - October 1986 



CHATR(l) CHATR(l) 

Series 500 Implementation 



DIAGNOSTICS 

Chatr generates an error message for the following conditions: 

no arguments are supplied - in this case the syntax is printed to the standard error file; 

cannot open a file; 

a request is made to modify a file which is not EXEC_MAGIC or SHAREL_MAGIC; 

working set size is larger than heap size. 

Chatr generates a warning message for the following conditions: 

the +p, -p, +h, or -h option is specified for a file which is a one data segment program; 

the -m or -w option is specified for a file which is a one data segment program, or a file 
for which the data is unpaged. 
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NAME 

chmod - change mode 

SYNOPSIS 

chmod mode file ... 

DESCRIPTION 

The permissions of the named files are changed according to mode, which may be absolute or 
symbolic. An absolute mode is an octal niunber constructed from the OR of the following modes: 

4000: set user ID on execution 

2000: set group ID on execution 

1000: sticky bit, see chmod{2) 

0400: read by owner 

0200: write by owner 

0100: execute (search in directory) by owner 

0070: read, write, execute (search) by group 

0007: reeid, write, execute (search) by others 

A symbolic mode has the form: 

[ who ] op permission [ op permission ] 

The who part is a combination of the letters u (for user's permissions), g (group) and o (other). 
The letter a stands for ugo, the default if who is omitted. 

Op can be + to add permission to the file's mode, - to take away permission, or = to assign per- 
mission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or 
group ID) and t (save text or sticky); u, g or o indicate that permission is to be taken from the 
current mode. Omitting permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by commas may be given. Operations are performed in the 
order specified. The letter s is only useful with u or g and t only works with u. 

Only the owner of a file (or the super-user) may change its mode. Only the super-user may set 
the sticky bit. In order to set the group ID, the group of the file must correspond to your current 
group ID. 

EXAMPLES 

The first example denies write permission to others, and the second makes a file executable: 

chmod o-w file 

chmod -l-x file 

The first example below assigns read and execute permission to everybody, and sets the set-user-id 
bit. The second assigns read and write permission to the file owner, and read permission to every- 
body else: 

chmod 4555 file 

chmod 644 file 

SEE ALSO 

ls(l), chmod(2). 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

chown, chgrp - change file owner or group 

SYNOPSIS 

chown owner file ... 

chgrp group file ... 

DESCRIPTION 

Chown changes the owner of the files to owner. The owner may be either a decimal user ID or a 
login name found in the password file. 

Chgrp changes the group ID of the files to group. The group may be either a decimal group ID or 
a group name found in the group file. 

In order to change the owner or group, you must own the file or be the super-user. If either com- 
mand is invoked by other than the super-user, the set-user-ID and set-group-ID bits of the file 
mode, 04000 and 02000 respectively, will be cleared. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

chmod(I), chown(2), group(4), passwd(4). 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

chsh - change default login shell 

SYNOPSIS 

chsh name [ shell ] 

DESCRIPTION 

Chah is a command similar to passwd{l), except that it is used to change the login shell field of 
the password file rather than the password entry. If no shell is specified then the shell reverts to 
the default login shell /bin/sh. Otherwise, only /bin/csh can be specified as the shell. 

An example use of this command is: 

chsh bill /bin/csh 

AUTHOR 

Chsh was developed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

csh(l), passwd(l), passwd(4). 
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NAME 

clear - clear terminal screen 

SYNOPSIS 
clear 

DESCRIPTION 

Clear clears your screen if this is possible. It reads the TERM environment variable for the ter- 
minal tjrpe and then reads the appropriate terminfo data base to figure out how to clear the 
screen. 

FILES 

/usr/lib/terminfo/?/* terminal database files 

AUTHOR 

Clear was develoj)ed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

terminfo(4). 
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NAME 

cmp - compare two files 

SYNOPSIS 

cmp [ -1 ] [ -s ] filel file2 

DESCRIPTION 

The two files are compared. (If filel is -, the standard input is used.) Under default options, 
cmp makes no comment if the files are the same; if they differ, it annoimces the byte and line 
number at which the difference occurred. If one file is an initial subsequence of the other, that 
fact is noted. 

Options: 

-1 Print the byte nmnber (decimal) and the differing bytes (octal) for each 

difference (byte numbering begins at 1 rather than 0). 

-8 Print nothing for differing files; return codes only. 

SEE ALSO 

comm(l), diff(l). 

DIAGNOSTICS 

Exit code is retiuned for identical files, 1 for different files, and 2 for an inaccessible or missing 
argument. 

INTERNATIONAL SUPPORT 

8-bit «ind 16-bit data, 8-bit filenames, messages. 
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NAME 

col - filter reverse line-feeds and backspaces 

SYNOPSIS 

col [ -blfxp ] 

DESCRIPTION 

Col reads from the standard input and writes onto the standard output. It performs the line 
overlays implied by reverse line feeds (ASCII code ESC-7), and by forward and reverse half-line 
feeds (ESC-9 and ESCs-l-l-S). Col is particularly useful for filtering multicolimin output made 
with the .rt command of nroff{l) and output resulting from use of the tbl{l) preprocessor. 

If the -b option is given, col assumes that the output device in use is not capable of backspacing. 
In this case, if two or more characters are to appear in the same place, only the last one read will 
be output. 

If the -1 option is given, col assiunes the output device is a line printer (rather than a character 
printer) and removes backspaces in favor of multiply overstruck full lines. It generates the 
minimiun number of print operations necessary to generate the required number of overstrikes. 
(All but the last print operation on a line are separated by carriage returns (\r); the last print 
operation is terminated by a newline (\n).) 

Although col accepts half-line motions in its input, it normally does not emit them on output. 
Instead, text that would appear between lines is moved to the next lower full-line boimdary. This 
treatment can be suppressed by the -f (fine) option; in this case, the output from col may contain 
forward half-line feeds (ESC-9), but will still never 
contain either kind of reverse line motion. 

Unless the -x option is given, col will convert white space to tabs on output wherever possible to 
shorten printing time. 

The ASCII control characters SO (\016) and SIs+1 (\017) are assumed by col to start and end text 
in an alternate character set. The character set to which each input character belongs is remem- 
bered, and on output SI and SO characters are generated as 
appropriate to ensure that each character is printed in the correct character set. 

On input, the only control characters accepted are space, backspace, tab, retiun, new-line, SI, SO, 
VT (\ 013), and ESC followed by 7, 8, or 9. The VT character is an alternate form of full 
reverse line-feed, included for compatibility with some earlier programs of this type. All other 
non-printing characters are ignored. 

Normally, col will ignore any unrecognized escape sequences found in its Input; the -p option may 
be used to cause col to output these sequences as regular characters, subject to overprinting from 
reverse line motions. The use of this option is highly discoinaged unless the user is fully aware of 
the textual position of the escape sequences. 

SEE ALSO 

nroff(l), tbl(l). 

NOTES 

The input format accepted by col matches the output produced by nroff with either the -T37 or 
-Tip options. Use -T37 (and the -f option of col) if the ultimate disposition of the output of 
col will be a device that can interpret half-line motions, and -Tip otherwise. 



BUGS 



Cannot back up more than 128 lines. 

There is a maximum limit for the nmnber of characters, including backspaces and overstrikes, on 

a line. The maximiun limit is at least 800 characters. 

Local vertical motions that would result in backing up over the first line of the document are 

ignored. As a result, the first line must not have any superscripts. 
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INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

comb - combine SCCS deltas 

SYNOPSIS 

comb [-psid] [-clist] [-o] [-s] files 

DESCRIPTION 

Comb generate a shell procedure (see ah{l)) which, when nm, will reconstruct the given SCCS 
files. The reconstructed files will, hopefully, be smaller than the ori^nal files. The arguments 
may be specified in any order, but all keyletter arguments apply to all named SCCS files. If a 
directory is named, comb behaves as though each file in the directory were specified as a named 
file, except that non-SCCS files (last component of the path name does not begin with s.) and 
imreadable files are silently ignored. If a name of — is given, the standard input is read; each line 
of the standard input is taken to be the name of an SCCS file to be processed; non-SCCS files and 
imreadable files are silently ignored. The generated shell procedure is written on the standard 
output. 

The keyletter arguments are as follows. Each is explained as though only one named file is to be 
processed, but the effects of any keyletter argimient apply independently to each named file. 

-paid The 5CCS /Dentification string (SID) of the oldest delta to be preserved. All 

older deltas are discarded in the reconstructed file. 

-clist A list (see get{l) for the syntax of a list) of deltas to be preserved. All other del- 

tas are discarded. 

-o For each get -e generated, this argument causes the reconstructed file to be 

accessed at the release of the delta to be created, otherwise the reconstructed file 
would be accessed at the most recent ancestor. Use of the -o keyletter may 
decrease the size of the reconstructed SCCS file. It may also alter the shape of 
the delta tree of the original file. 

-8 This argimient causes comb to generate a shell procedure which, when run, wUl 

produce a report giving, for each file: the file name, size (in blocks) after com- 
bining, original size (also in blocks), and percentage change computed by: 

100 * (original - combined) / original 
It is recommended that before any SCCS files are actually combined, one should 
use this option to determine exactly how much space is saved by the combining 
process. 

If no keyletter arguments are specified, comb will preserve only leaf deltas and the minimal 
number of ancestors needed to preserve the tree. 

FILES 

s.COMB The name of the reconstructed SCCS file. 

comb????? Temporary. 

SEE ALSO 

admm(l), delta(l), get(l), help(l), prs(l), sh(l), sccsfile(4). 

Source Code Control System User Guide in the HP-UX User's Guide. 

DIAGNOSTICS 

Use help{l) for explanations. 

BUGS 

Comb may rearrange the shape of the tree of deltas. It may not save any space; in fact, it is pos- 
sible for the reconstructed file to actually be larger than the original. 
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INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

comm - select or reject lines common to two sorted files 

SYNOPSIS 

comm [ - [ 123 ] ] filel file2 

DESCRIPTION 

Comm reads filel and file£, which should be ordered in ASCII collating sequence (see sort{i}), 
and produces a three-column output: lines only in filel ; lines only in file2; and lines in both files. 
The file name - means the standsird input. 

Flags 1, 2, or 3 suppress printing of the corresponding colimm. Thus coimn -12 prints only the 
lines common to the two files; comm -23 prints only lines in the first file but not in the second; 
comm -123 is a no-op. 

SEE ALSO 

cmp(l), diff(l), sdiir(l), sort(l), uniq(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

compact, uncompact, ccat - compress and uncompress files, and cat them 

SYNOPSIS 

compact [ name ... ] 
uncompact [ name ... ] 
ccat [ file ... ] 

DESCRIPTION 

Compact compresses the named files using an adaptive Hufiinan code. If no file names are given, 
the standard input is compacted to the standard output. Compact operates as an on-line algo- 
rithm. Each time a byte is read, it is encoded immediately according to the current prefix code. 
This code is an optimal Hufi&nan code for the set of frequencies seen so far. It is unnecessary to 
attach a decoding tree in front of the compressed file since the encoder and the decoder start in 
the same state and stay synchronized. Furthermore, compact and uncompact can operate as 
filters. In particular, 

... I compact I imcompact I ... 

operates as a (very slow) no-op. 

When an argimient file is given, it is compacted and the resulting file is placed in file.C; file is 
unlinked. The first two bytes of the compacted file code the fact that the file is compacted. This 
code is used to prohibit recompaction. 

The amoimt of compression to be expected depends on the type of file being compressed. Typical 
values of compression are: Text (38%), Pascal Source (43%), C Source (36%) and Binary (19%). 
These values are the percentages of file bytes reduced. 

Uncompact restores the original file from a file compressed by compact. If no file names are given, 
the standard input is imcompacted to the standard output. 

Ccat cats the original file from a file compressed by compact, without uncompressing the file. 

RESTRICTION 

The last segment of the filename must contain fewer than thirteen characters to allow space for 
the appended '.C. 

FILES 

*.C compacted file created by compact, removed by imcompact 

SEE ALSO 

Gallager, Robert G., 'Variations on a Theme of HufiPman', I.E.E.E. Transactions on Information 
Theory, vol. IT-24, no. 6, November 1978, pp. 668 - 674. 
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NAME 

compress, uncompress, zcat - compress and expand data 

SYNOPSIS 

compress ( -f ] ( -v ] [ -c ] [ -V ] [ -b bits ] [ name ... ] 
uncompress [ -f ) [ -v ] [ -c ] [ -V ) [ name ... ] 
zcat [ -V ] [ name ... ] 

DESCRIPTION 

Compress reduces the size of the named files using adaptive Lempel-Ziv coding. Whenever possi- 
ble, each file is replaced by one with the extension .Z, while keeping the same ownership modes, 
access and modification times. If no files are specified, the standard input is compressed to the 
standard output. Compressed files can be restored to their original form using uncompress or 
zcat. 

The -f option will force compression of name. This is useful for compressing an entire directory, 
even if some of the files do not actually shrink. If -f is not given and compress is run in the fore- 
ground, the user is prompted as to whether an existing file should be overwritten. 

The -c option makes compress/uncompress write to the standard output; no files are changed. 
The nondestructive behavior of zcat is identical to that of uncompress -c. 

Compress uses the modified Lempel-Ziv algorithm popularized in "A Technique for High Perfor- 
mance Data Compression", Terry A. Welch, IEEE Computer, vol. 17, no. 6 (Jime 1984), pp. 8-19. 
Common substrings in the file are first replaced by 9-bit codes 257 and up. When code 512 is 
reached, the algorithm switches to 10-bit codes and continues to use more bits until the limit 
specified by the -b flag is reached (default 16). Bits must be between 9 and 16. The default can 
be changed in the source to allow compress to be nm on a smaller machine. 

After the bits limit is attained, compress periodically checks the compression ratio. If it is increas- 
ing, compress continues to use the existing code dictionary. However, if the compression ratio 
decreases, compress discards the table of substrings and rebuilds it from scratch. This allows the 
algorithm to adapt to the next "block" of the file. 

Note that the -b flag is omitted for uncompress, since the bits parameter specified during 
compression is encoded within the output, along with a magic nmnber to ensure that neither 
decompression of random data nor recompression of compressed data is attempted. 

The amoimt of compression obtained depends on the size of the input, the number of bits per 
code, and the distribution of common substrings. Typically, text such as source code or English is 
reduced by 50-60%. Compression is genereilly much better than that achieved by Huffman coding 
(as used in pack), or adaptive Huffman coding (compact), and takes less time to compute. 

Under the -v option, a message is printed yielding the percentage of reduction for each file 
compressed. 

If the -V option is specified, the current version and compile options are printed on stderr. 

Exit status is normally 0; if the last file is larger after (attempted) compression, the status is 2; if 
an error occurs, exit status is 1. 

SEE ALSO 

pack(l), compact(l) 

DIAGNOSTICS 

Usage: compress [-dfvcV] [-b maxbits] [file ...] 

Invalid options were specified on the command line. 
Missing maxbits 

Maxbits must follow -b. 
file: not in compressed format 

The file specified to uncompress has not been compressed. 
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file: compressed with xx bits, c£in only handle yy bits 

File was compressed by a program that could deal with more bits than the 

compress code on this machine. Recompress the file with smaller bits, 
file: £ilready has .Z sufiix — no change 

The file is assumed to be already compressed. Rename the file and try again. 
file: filename too long to tack on .Z 

The file cannot be compressed because its n£ime is longer than 12 characters. 

Rename and try again. This message does not occin: on BSD systems. 
file already exists; do you wish to overwrite (y or n)? 

Respond "y" if you want the output file to be replaced; "n" if not. 
uncompress: corrupt input 

A SIGSEGV violation was detected which usually means that the input file has 

been corrupted. 
Compression: xx.xx% 

Percentage of the input saved by compression. (Relevant only for -v.) 

— not a regular file: unchsmged 

When the input file is not a regulsir file, (e.g. a directory), it is left unaltered. 

— has xx other links: unchanged 

The input file has links; it is left imchanged. See /n(l) for more information. 

— file imchanged 

No savings is achieved by compression. The input remains virgin. 

BUGS 

Although compressed files are compatible between machines with l£irge memory, -bl2 should be 
used for file transfer to architectures with a small process data space (64K bytes or less, as exhi- 
bited by the Digital Equipment Corporation PDP series, the Intel 80286, etc.) 
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NAME 

cp, In, mv - copy, link or move files 

SYNOPSIS 

cp [ -r ] filel [ file2 ...] target 
in [ -f ] filel [ file2 ...] target 
mv [ -f ] filel [ file2 ...] target 

DESCRIPTION 

Filel is copied (linked, moved) to target. Under no circmnstance can filel and target be the same 
(take care when using sh{l) metachsu-acters). If target is a directory, then one or more files are 
copied (linked, moved) to that directory. If two or more files are specified for any of these com- 
mands (not counting target), then target must be a directory. If target is a file, its contents are 
destroyed. 

If the -r option is specified, then for each soiu-ce directory cp copies the subtree rooted at that 
directory to target. If target exists it must be a directory, in which case cp creates a directory 
within target with the same name as source, and then copies the subtree rooted at source to 
target/source. It is an error if target/source already exists. If target does not exist, cp creates it 
and then copies the subtree rooted at source to target. Note that cp -r will not merge subtrees. 
Target should not reside beneath source, and source should not have a cyclic directory structure, 
since in these cases cp will attempt to copy an infinite amount of data. 

If mv or In determines that the mode of target forbids writing, it will ask permission to overwrite 
the file. This is done by printing the mode (see chmod{2)) followed by the first letters for the 
words yes and no in the current native language, asking for a response, and reading the standard 
input for one line. If the response begins with the first of the choices displayed and if permissible, 
the operation occurs; if not, the command exits. No questions are asked and the mv or In is done 
when the -f option is used or if the stemdard input is not a terminal. 

If filel is a directory, mv reneimes filel to target only if the two directories have the same parent. 
Ln does not permit filel to be a directory. Cp permits filel to be a directory only if the -r option 
is specified. If filel is a file and target is a link to another file with links, the other links remain 
and target becomes a new file. When using cp, if target is not a file, a new file is created which 
has the same mode as filel except that the sticky bit is not set unless you are super-user; the 
owner and group of target are those of the user. If target is a file, copying a file into target does 
not change its mode, owner, nor group. The last modification time of target (and last access time, 
if target did not exist) and the last access time of filel are set to the time the copy was made. If 
target is a link to a file, all links remain and the file is changed. 

You c«uanot use mv to perform the following operations: 

rename either the current working directory or its parent directory using the "." or ".." 
notation; 

rename a directory such that its new name is the same as the name of a file contained in 
that directory. 

SEE ALSO 

cpio(l), link(lM), rm(l), chmod(2). 

BUGS 

If filel and target lie on different file systems, mv must copy the file and delete the original. In 
this case the owner becomes that of the copying process and any linking relationship with other 
files is lost. Ln cannot not create hard links across file systems. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

cplo -o ( aBcxv ] 

cpio -i [ BdcrtuxvmfP8Sb6R ] [ patterns ] 

cpio -p [ aduxvlm ] directory 

DESCRIPTION 

Cpio -o (copy out) reads the standard input to obtain a list of path names and copies those files 
onto the standard output together with path name and status information. Output is padded to 
a 512-byte boundary. 

Cpio -i (copy in) extracts files fi-om the standard input, which is assumed to be the product of a 
previous cpio -o. Only files with names that match patterns are selected. Patterns are given in 
the name-generating notation of sh{i). In patterns, meta-characters ?, *, and [ . . .] match the 
slash / character. Multiple patterns may be specified and if no patterns are specified, the default 
for patterns is * (i.e., select all files). The extracted files are conditionally created and copied into 
the current directory tree based upon the options described below. The permissions of the files 
will be those of the previous cpio -o. The owner and group of the files will be that of the current 
user unless the user is super-user, which causes cpio to retain the owner and group of the files of 
the previous cpio -o. 

Cpio -p (pass) reads the standard input to obtain a list of path names of files that are condition- 
ally created and copied into the destination directory tree based upon the options described below. 
Destination path names are interpreted relative to the named directory. 

The meanings of the available options are: 

a Reset access times of input files after they have been copied. 

B Input /output is to be blocked 5,120 bytes to the record (does not apply to the 

pass option); meaningful only with data directed to or from devices which sup- 
port variable length records such as magnetic tape. 

d Create directories as needed. 

c Write header information in ASCII character form for portability. 

r Interactively rename files. If the user types a null line, the file is skipped. 

t Print only a table of contents of the input. No files are created, read, or copied. 

u Copy imconditionally (normally, an older file will not replace a newer file with 

the same name). 

X Save or restore device special files. Mknod{2) will be used to recreate these files 

on a restore, and thus -ix can only be used by the super-user. Restoring device 
files onto a different system can be very dangerous. This is intended for intrasys- 
tem (backup) use. 

V Verbose: causes a list of file names to be printed. When used with the t option, 

the table of contents looks like the output of an is -1 command (see ls{l)). 

1 Whenever possible, link files rather than copying them. This option does not 

destroy existing files. Usable only with the -p option. 

m Retain previous file modification time. This option is ineffective on directories 

that are being copied. 

f Copy in all files except those in patterns. 

P Read a file written on a PDP-11 or VAX system (with byte swapping) that 

did not use the -c option. Only usefiil with -i (copy in). Files copied in this 
mode are not changed. Non-ASCII files will probably need further processing to 
be readable, this processing often requires knowledge of the content of the file 
and thus cannot always be done by this program. (PDP-11 and VAX are 
registered trademarks of Digital Equipment Corporation). The -s , -S and -b 
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just the headers, is appropriate. In general, text is best processed with -P and 
binary data with one of the other options, 
s Swap all bytes of the file. Use only with the -i option. 

5 Swap all halfwords of the file. Use only with the -i option. 

b Swap both bytes and halfwords. Use only with the -i option. 

6 Process a UNIX Sixth Edition format file. Only useful with -i (copy in). 

R Resynchronize automatically when cpio gets 'Out of phase," (see DIAGNOS- 

TICS). 

Note that cpio archives created using a raw device file must be read using a raw device file. 

When the end of the tape is reached, cpio will prompt the user for a new special file and continue. 

If you want to pass one or more metacharacters to cpio without the shell expandmg them, be sure 
to precede each of them with a backslash (\). 

Device files written with the -ox option (e.g., /dev/tty03) will not transport to other implemen- 
tations of HP-UX. 

HARDWARE DEPENDENCIES 

General: 

The use of cpio with cartridge tape units requires additional comments. For an explanation 
of the constraints on cartridge tapes, see ct{7). 

Warning: using cpio to write directly to a cartridge tape unit can severely damage the tape 
drive in a short amount of time, and is therefore strongly discoiu'aged. The recommended 
method of writing to the cartridge tape unit is to use tcio{l) in conjunction with cpio (note 
that -B must not be used when tcio{l) is used). Tcio{l) buffers data into larger pieces suit- 
able for cartridge tapes. 

The -B option must be used when writing directly (i.e., without using tcio{l)) to a CS-80 
cartridge tape unit. 

At and before release 4.0 on the 500 and 2.2 on the 200 and 300, these systems wrote a for- 
mat which, when crossing media boimdaries on some kinds of disks, differs from the format 
specified by System V.2 (although it matched that written by System III). The program 
/etc/ocpio will read and write this format and has essentially the same featiures as cpio 
except that options -S, -b and -f are omitted. However, /etc/ocpio is considered obsoles- 
cent. 

Series 500: 

All files with inodes greater than or equal to 65535 are unlinkable with the -i option. A 
separate copy of each file is made instead. 

The number of blocks reported by cpio is always in units of 512-bjrte blocks, regardless of 
the block size of the initialized media. 

Note that the -B option must not be used when performing raw I/O to the internal minia- 
ture flexible disk drive (HP 9130K), if the I/O requires more than one volmne. 

EXAMPLES 

The first example below copies the contents of a directory into an archive; the second duplicates a 
directory hierarchy: 

Is I cpio -o >/dev/rmt/Oin 

cd olddlr 

find . -depth -print | cpio -pdl newdir 

The trivial case "find . -depth -print | cpio -oB >/dev/rmt/Om" can be handled more 
efficiently by: 
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find . -cpio /dev/rmt/Om 

SEE ALSO 

ar(l), find(l), tar(l), tcio(l), cpio(4). 

DIAGNOSTICS 

The diagnostic message "Out of phase" indicates that cpio could not successfully read its particu- 
lar "magic number" in the header. Without the R option specified, cpio will fail and return exit 
code 2. With the R option, cpio will try resyncing automatically. (Resyncing means that cpio 
tries to find the next good header in the archive and continues processing from there.) If cpio 
tries to resynchronize from being "Out of phase", it will retium exit code 1. If resynchronization 
fails, try changing header mode (c option) or byte swapping the header (P or s options). 

WARNING 

Do not redirect the output of cpio to a named cpio archive file which resides in the same directory 
as the original files which are part of that cpio archive. This can cause loss of data. 

BUGS 

Path names are restricted to 256 characters. If there are too many imique linked files, the pro- 
gram nms out of memory to keep track of them and, thereafter, linking information is lost. Only 
the super-user can copy special files. 

Cpio tapes written on HP machines with the -ox[c] options can mislead (non-HP) versions of 
cpio which do not support the -x option. If a non-HP (and non-AT&T) version of cpio happens 
to be modified so that (HP) cpio recognizes it as a device special file, a spurious device file could 
be created. 

If /dev/tty is not accessible, cpio issues a complaint, or refuses to work. 

The -pd option wiU not create the directory typed on the conunand line. 

The -idr option will not make empty directories. 

The -plu option will not link files to existing files. 

Cpio will fail while restoring files from a backup tape (cpio -i) if the following conditions are 
met: 

your working directory during the restore is not the root directory (/), 
and the files being restored have multiple links, 
and their path names begin with slash (/). 

If these conditions are met, the following occurs: 

(1) The first file on the backup tape is restored correctly; 

(2) The second file is removed, and the restore fails. 

Note that the second file is removed before the restore fails! 

Cpio then writes the message "Cannot link filel & fileS" to stderr, but also writes "filel linked to 
file£" on stdout, as if everything went fine. The correct message is that written to stderr. 

There are two work-aroimds for this bug, either of which will solve the problem. The first is to 
make sure that your working directory is the root directory during the restore process. The 
second is to use relative file names (path names not begiiming with slash) in your backup. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

cpp - the C language preprocessor 

SYNOPSIS 

/lib/cpp [ option ... ] ( ifile [ ofile ] ] 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the first pass of any C compilation using 
the cc(l) command. Its purpose is to process include and conditional compilation instructions, 
and macros. Thus the output of cpp is designed to be in a form acceptable as input to the next 
pass of the C compiler. As the C language evolves, cpp and the rest of the C compilation package 
will be modified to follow these changes. Therefore, the use of cpp other than in this framework is 
not suggested. The preferred way to invoke cpp is through the cc(l) command, since the func- 
tionality of cpp may someday be moved elsewhere. See m4{\) for a general macro processor. 

Cpp optionally accepts two file names as eirgimaents. Ifile and ofile are respectively the input and 
output for the preprocessor. They default to standard input and standard output if not supplied. 

The following options to cpp are recognized: 

-P Preprocess the input without producing the line control information used by the next pass 
of the C compiler. 

-C By default, cpp strips C-style comments. If the -C option is specified, all comments 
(except those foimd on cpp directive lines) are passed along. 

-Unome 

Remove any initial definition of name, where name is a reserved symbol that is predefined 
by the particular preprocessor. The ciurent list of these possibly reserved symbols 
includes: 

operating system: mert, ibm, gcos, os, tss, imix 

hardware: hp9000s800, hp9000s500, hp9000s300, hp9000s200, 

hp9000ipc, interdata, pdpll, u370, u3b, u3b5, vax 
UNIX systems variant: 

RES, RT, TS, PWB, hpux 
lint{l): lint 

All HP-UX systems will have the symbols PWB, hpux, and unix defined. Each system 
will define exactly one hardware variant, as appropriate. The lint symbol will be defined 
when lint{l) is running. 
-Dnome 
-'Dname=def 

Define name as if by a #define directive. If no =def is given, name is defined as 1. The 
-D option has lower precedence than the -U option. That is, if the same name is used in 
both a -U option and a -D option, the nemie will be imdefined regardless of the order of 
the options. 

-T On HP-UX, preprocessor symbols are no longer restricted to eight characters. The -T 
option forces cpp to use only the first eight characters for distinguishing different prepro- 
cessor names. This behavior is the same as preprocessors on some other systems with 
respect to the length of names and is included for backward compatability. 

-Idir Change the algorithm for searching for #include files whose neimes do not begin with / 
to look in dir before looking in the directories on the standard list. Thus, #include files 
whose names are enclosed in " " will be searched for first in the directory of the file con- 
taining the #include line, then in directories named in -I options in left-to-right order, 
and last in directories on a standard list. For #include files whose names are enclosed in 
<>, the directory of the file containing the #include line is not searched. However, the 
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directory dir is still searched. 

-Hnnn Change the internal macro definition table to be nnn bytes in size. The macro symbol 
table will be increased proportionally. The default table size is at least 36000 bytes. This 
option serves to eliminate the "too many defines" and "too much defining" errors. 

Two special names are understood by cpp. The name LINE is defined as the cmrent line 

munber (as a decimal integer) as known by cpp, and FILE: is defined as the ciurent file 

name (as a C string) as known by cpp. They can be used anywhere (including in macros) just as 
any other defined name. 

All cpp directives start with lines begun by #. Any munber of blanks and tabs are allowed 
between the # and the directive. The directives are: 

#define name token-atring 

Replace subsequent instances of name with token-string, {token-string may be null). 

#define name{arg, ..., arg) token-string 

Notice that there can be no space between name and the (. Replace subsequent instances 
of name followed by a (, a list of comma-separated set of tokens, and a ) by token-atring, 
where each occurrence of an arg in the token-atring is replaced by the corresponding set of 
tokens in the comma-separated list. When a macro with arguments is expanded, the 
argiunents are placed into the expanded token-atring unchanged. After the entire token- 
string has been expanded, cpp re-starts its scan for names to expand at the beginning of 
newly created token-string. 

#undef name 

Cause the definition of name (if any) to be forgotten from now on. 

^include "filename" 
#include <filename> 

Include at this point the contents of filename (which will then be nm through cpp). See 

the -I option above for more detail. 

#line integer-constant "filename" 

Causes cpp to generate line control information for the next pass of the C compiler. 
Integer-constant is the line munber of the next line and filename is the file where it comes 
from. If "filename" is not given, the cmrent file name is imchanged. 

#endif <text> 

Ends a section of lines begim by a test directive (#if, #ifdef, or #ifndef). Each test 
directive must have a matching #endif. Any text occiuring on the same line as the 
#endif is ignored and thus may be used to mark matching #if-#endif pairs. This 
makes it easier, when reading the soiurce, to match #if, #ifdef, and #ifiidef directives 
with their associated #endif directive. 

#ifdef name 

The lines following will appear in the output if and only if name has been the subject of a 
previous #deflne without being the subject of an intervening #undef. 

#ifhdef name 

The lines following will not appear in the output if and only if name has been the subject 
of a previous #define without being the subject of an intervening #undef. 

#if constant-expression 

Lines following will appear in the output if and only if the constant-expression evaluates 
to non-zero. All binary non-assignment C operators, the ?: operator, the imary — , !, and 
operators are all legal in constant-expression. The precedence of the operators is the 
same as defined by the C language. There is also a unary operator defined, which can be 
used in constant-expression in these two forms: defined ( name ) or defined name. 
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This allows the utility of #ifdef and #ifiidef in a #if directive. Only these operators, 
integer constants, and names which are known by cpp should be used in constant- 
expreasion. In particular, the sizeof operator is not available. 

#el8e Reverses the notion of the test directive which matches this directive. Thus if lines previ- 
ous to this directive are ignored, the following lines will appear in the output, and vice 
versa. 

The test directives and the possible #el8e directives can be nested. Cpp supports names up to 
255 characters in length. 

HARDWARE DEPENDENCIES 

Series 200, 300: 

In the hardware name definition associated with predefined symbols (see -U option), two 
hardware variants are defined instead of one. Both hp9000s200 and hp9000s300 are present, 
and they are treated synonymously because of the similarity between the two series. 

FILES 

/usr /include standard directory for #include files 

SEE ALSO 

cc(l), m4(l). 

DIAGNOSTICS 

The error messages produced by cpp are intended to be self-explanatory. The line nmnber and 
filename where the error occurred are printed along with the diagnostic. 

NOTES 

When new-line characters were found in argument lists for macros to be expanded, previous ver- 
sions of cpp put out the new-lines as they were foimd and expanded. The current version of cpp 
replaces these new-lines with blanks to alleviate problems that the previous versions had when 
this occiured. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 






crontab - 


user 


crontab file 


SYNOPSIS 






crontab 


[file] 




crontab 


-r 




crontab 


-1 





DESCRIPTION 

Crontab copies the specified file, or standard input if no file is specified, into a directory that holds 
all users' crontabs. The -r option removes a user's crontab fi-om the crontab directory. Crontab 
-1 will list the crontab file for the invoking user. 

A user is permitted to use crontab if their name appears in the file /usr/lib/cron/cron.allow. If 
that file does not exist, the file /nsr/Iib/cron/cron.deny is checked to determine if the user 
should be denied access to crontab. If neither file exists, only root is allowed to submit a job. If 
only cron.deny exists and is empty, global usage is permitted. The allow/deny files consist of 
one user name per line. 

A crontab file consists of lines of six fields each. The fields are separated by spaces or tabs. The 
first five are integer patterns that specify the following: 

minute (0-59), 

hour (0-23), 

day of the month (1-31), 

month of the year (1-12), 

day of the week (0-6 with 0=Simday). 

Each of these patterns may be either an asterisk (meaning all legal values), or a list of elements 
separated by commas. An element is either a niunber, or two numbers separated by a minus sign 
(meaning an inclusive range). Note that the specification of days may be made by two fields (day 
of the month and day of the week). If both are specified as a list of elements, both are adhered 
to. For example, 1,15 * 1 would run a command on the first and fifteenth of each month, as 
well as on every Monday. To specify days by only one field, the other field should be set to * (for 
example, 0**1 would run a command only on Mondays). 

The sixth field of a line in a crontab file is a string that is executed by the shell at the specified 
times. A percent character in this field (unless escaped by \) is translated to a new-line character. 
Only the first line (up to a % or end of line) of the command field is executed by the shell. The 
other lines are made available to the conunand as standard input. 

The shell is invoked from yoiu- SHOME directory with an argO of sh. Users who desire to have 
their .profile executed must explicitly do so in the crontab file. Cron supplies a defaxilt environ- 
ment for every shell, defining HOME, LOGNAME, SHELL(=/bin/8h), and 
PATH(=:/bin:/usr/bin:/usr/lbin). 



NOTE 



FILES 



Users should remember to redirect the standard output and standard error of their commemds! If 
this is not done, any generated output or errors will be mailed to the user. 

/usr/lib/cron main cron directory 

/usr/lib/cron/cron.allow list of allowed users 

/usr/lib/cron/cron.deny list of denied users 

/usr/spool/cron/crontabs spool area 

/usr/lib/cron/log accoimting information 
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SEE ALSO 

cron(lM), sh(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

crypt - encode/decode files 

SYNOPSIS 

crypt [ password ] 

REMARKS 

The decryption facilities provided by this software are under control of the United States Govern- 
ment and cannot be exported without special licenses. These capabilities are only available by 
special arrangement through HP. 

DESCRIPTION 

Crypt reads from the standard input and writes on the standard output. The password is a key 
that selects a particular transformation. If no password is given, crypt demands a key from the 
terminal and tinns off printing while the key is being typed in. Crypt encrypts and decrypts with 
the same key: 

crypt key <clear >cypher 
crypt key <cypher | pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor ed in encryption mode. 

The security of encrypted files depends on three factors: the fimdamental method must be hard 
to solve; direct search of the key space must be infeasible; "sneak paths" by which keys or clear 
text can become visible must be minimized. 

Crypt implements a one-rotor machine designed along the lines of the German Enigma, but with a 
256-element rotor. Methods of attack on such machines are known, but not widely; moreover the 
amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed to be 
expensive, i.e., to take a substantial fraction of a second to compute. However, if keys are res- 
tricted to (say) three lower-case letters, then encrypted files can be read by expending only a sub- 
stantial fraction of five minutes of machine time. 

Since the key is an argmnent to the crypt command, it is potentially visible to users executing 
p8(l) or a derivative. The choice of keys and key security are the most vulnerable aspect of crypt. 

FILES 



/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(l), stty(l). 



BUGS 



If output is piped to nroff{l) and the encryption key is not given on the conunand line, crypt can 
leave terminal modes in a strange state (see stty{l)). 

If two or more files encrypted with the same key are concatenated and an attempt is made to 
decrypt the result, only the contents of the first of the original files will be decrypted correctly. 
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NAME 

csh - a shell (command interpreter) with C-like syntax 

SYNOPSIS 

csh ( -cefinstvxTVX ] ( command file ] [ argimient list ... ] 

DESCRIPTION 

Csh is a command language interpreter incorporating a command history buffer and a C-like syn- 
tax. If supported by the system, csh also contains job control facilities. 

The command options are interpreted as follows: 

-c Commands are read from the (single) following argument which must be present. 

Any remaining arguments are placed in argv. 

-c The shell exits if any invoked command terminates abnormally or yields a non- 

zero exit status. 

-f Suppress execution of the .cshrc file in your home directory, thus speeding up 

shell start-up time. 

-i Forces csh to respond interactively when called firom a device other than a com- 

puter terminal, such as another computer. Csh normally responds non- 
interactively. If csh is called from a computer terminal, it always responds 
interactively, no matter which options are selected. 

-n This option causes commands to be parsed, but not executed. This may be used 
in syntactic checking of shell scripts. All substitutions are performed (history, 
conunand, alias, etc.). 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. 

-V This option causes the verbose shell variable to be set. This causes conunand 
input to be echoed to your standard output device after history substitutions are 
made. 

-X This option causes the echo shell variable to be set. This causes all commands to 
be echoed to the standard output immediately before execution. 

-T This option disables the tenex features, which use the ESCAPE key for 
command/filename completion and control-D for listing available files (see the 
CSH UTILITES section below) 

-V This option causes the verbose variable to be set before .cshrc is executed. This 
means all .cshrc conunands are also echoed to the standard output. 

-X This option causes the echo variable to be set before .cshrc is executed. This 
means all .cshrc commands are also echoed to the standard output. 

After processing the command options, if arguments remain in the argument list, and the -c, -i, 
-8, or -t options were not specified, the first remaining argument is taken as the name of a file of 
commands to be executed. 

CONfMANDS 

A simple conmiand is a sequence of words, the first of which specifies the command to be exe- 
cuted. A sequence of simple commands separated by vertical bar ( I ) characters forms a pipeline. 
The output of each conmiand in a pipeline is made the input of the next conmiand in the pipeline. 
Sequences of pipelines may be separated by semicolons (;), and are then executed sequentially. A 
sequence of pipelines may be executed in backgroimd mode by following the last entry with an 
ampersand (&) character. 
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Any pij)elme may be placed in parenthesis to form a simple command which in turn may be a 
component of another pipeline. It is also possible to separate pipelines with "I I" or "&&" indi- 
cating, as in the C language, that the second pipeline is to be executed only if the first fails or 
succeeds, respectively. 

Jobs 

The shell associates a job with each pipeline. It keeps a table of current jobs, printed by the jobs 
command, and assigns them small integer numbers. When a job is started asynchronously with 
'&', the shell prints a line which looks like: 

[1] 1234 

indicating that the job which was started asynchronously was job number 1 and had one (top- 
level) process, whose process id was 1234. 

For those systems which support job control, if you are nmning a job and wish to do something 
else you may type the currently defined suspend character (see termio{7)) which sends a stop sig- 
nal to the current job. The shell will then normally indicate that the job has been 'Stopped', and 
print another prompt. You can then memipulate the state of this job, putting it in the back- 
groimd with the bg command, or run some other commands and then eventually bring the job 
back into the foreground with the foregroimd command fg. A suspend takes effect immediately 
and is like an interrupt in that pending output and um-ead input are discarded when it is typed. 
There is a delayed suspend character which does not generate a stop signal until a program 
attempts to read{2) it. This can usefully be typed ahead when you have prepared some com- 
mands for a job which you wish to stop after it has read them. 

A job being nm in the backgroimd will stop if it tries to read from the terminal. Background jobs 
are normally allowed to produce output, but this can be disabled by giving the conunand "stty 
tostop". If you set this tty option, then background jobs will stop when they try to produce out- 
put like they do when they try to read input. 

There are several ways to refer to jobs in the shell. The character '%' introduces a job name. If 
you wish to refer to job number 1, you can name it as '%1'. Just naming a job brings it to the 
foregroimd; thus '%1' is a synonym for 'fg %l\ bringing job 1 back into the foregroimd. Similarly 
saying '%1 ic' resumes job 1 in the bswikgroimd. Jobs can also be nJimed by prefixes of the string 
typed in to start them, if these prefixes are unambiguous, thus '%ex' would normally restart a 
suspended ex{l) job, if there were only one suspended job whose name began with the string 'ex'. 
It is also possible to say '%?string' which specifies a job whose text contains string, if there is only 
one such job. 

The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, the 
current job is marked with a '-I-' and the previous job with a '-'. The abbreviation '%-t-' refers to 
the current job and '%-' refers to the previous job. For close ansdogy with the syntax of the his- 
tory mechanism (described below), '%%' is also a synonym for the current job. 

Csh learns immediately whenever a process changes state. It normally informs you whenever a 
job becomes blocked so that no further progress is possible, but only just before printing a 
prompt. This is done so that it does not otherwise distiu-b your work. If, however, you set the 
shell variable notify, csh will notify you immediately of changes in status of background jobs. 
There is also a csh built-in command called notify which marks a single process so that its status 
changes will be immediately reported. By default, notify marks the current process. You can just 
say 'notify' after starting a background job to mark it. 

When you try to leave the shell while jobs are stopped, you will be warned that 'You have 
stopped jobs.' You may use the jobs command to see what they are. If you do this or immedi- 
ately try to exit again, the shell will not warn you a second time, and the suspended jobs will be 
terminated (see exit {2)). 
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Built-in Commands 

Built-in commands are executed within the shell. If a built-in command occurs as any component 
of a pipeline except the last then it is executed in a subshell. The built-in commands are: 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form prints the alias for name. The final 
form assigns the specified wordlist as the alias of name. Command and filename substitu- 
tion are performed on wordlist. Name cannot be alias or unalias. 

bg [ %job ...] 

Puts the current (no argument) or specified jobs into the backgroimd, continuing them if 
they were stopped. This command is supported only if job control is available. 

break Causes execution to resiune after the end of the nearest enclosing for each or while. The 
remaining commands on the ciurent line are executed. Multi-level breaks are thus possi- 
ble by writing them all on one line. 

breaksw 

Causes a break from a switch, resinning after the endsw. 

case label: 

A label in a switch statement as discussed below. 

cd 

cd directory— name 

chdir 

chdir directory—name 

Change the shell's current working directory to directory— name . If no argument is given, 

then directory—name defaults to your home directory. 

If directory— name is not foimd as a subdirectory of the current working directory (and 
does not begin with "/", "./" or "../")> t^®° ®*ch component of the variable cdpath is 
checked to see if it has a subdirectory directory— name. Finally, if all else fails, csh treats 
directory— name as a shell variable. If its value begins with "/", then this is tried to see if 
it is a directory. 

continue 

Continue execution of the nearest enclosing while or for each. The rest of the commands 
on the current line are executed. 

default: 

Labels the default case m a switch statement. The default should come after all other 
case labels. 

dirs Prints the directory stack; the top of the stack is at the left; the first directory in the 
stack is the cmrent directory. 

echo wordlist 
echo -n wordlist 

The specified words are written to the shell's standard output, separated by spaces, and 

terminated with a new-line imless the -n option is specified. 

else 

end 

endif 

endsw See the description of the for each, if, switch, and while statements below. 

eval arguments ... 

(As in sh{l).) The arguments are read as input to the shell and the resulting 
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coininand(s) executed. This is usually used to execute commands generated as the result 
of command or variable substitution, since parsing occurs before these substitutions. 

exec command 

The specified command is executed in place of the current shell. 

exit 

exit (expression) 

The shell exits either with the value of the stattis variable (first form) or with the value of 

the specified expression (second form). 

fg [ %job ...] 

Brings the current (no argmnent) or specified jobs into the foreground, continuing them if 
they were stopped. This command is supported only if job control is available. 

foreach name (wordlist) 

end The variable name is successively set to each member of wordlist and the sequence of 
commands between this command and the matching end are executed. (Both foreach and 
end must appear alone on separate lines.) 

The built-in command continue may be used to continue the loop prematurely and the 
built-in command break terminates it prematurely. When this command is read from the 
terminal, the loop is read once, prompting with '?' before any statements in the loop are 
executed. If you make a mistake while typing in a loop at the terminal you can then rub 
it out. 

glob wordlist 

Like echo but no '\' escapes are recognized and words are delimited by null characters in 
the output. Useful for programs which wish to use the shell to perform filename expan- 
sion on a list of words. 

goto word 

The specified word is filename and command expanded to yield a string of the form 
'label'. The shell rewinds its input as much as possible and searches for a line of the form 
'label:' possibly preceded by blanks or tabs. Execution continues after the specified line. 

hashstat 

Print a statistics line indicating how effective the internal hash table has been at locating 
commands (and avoiding exec's). An eiec is attempted for each component of the path 
where the hash function indicates a possible hit, and in each component which does not 
begin with a '/'. 

history 
history n 
history -r n 

Displays the history event list; if n is given only the n most recent events are printed. 
The -r option reverses the order of printout to be most recent first rather than oldest 
first. 

if (expression) command 

If the specified expression evaluates true, then the single command with arguments is exe- 
cuted. Variable substitution on command happens early, at the same time it does for the 
rest of the if command. Command must be a simple command, not a pipeline, a com- 
mand list, or a parenthesized command list. Input/output redirection occurs even if 
expression is false, when command is not executed (this is a bug). 

if (expressionl) then 
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else if {expressions) then 

else 

endif If the specified expressionl is true then the commands to the first else are executed; oth- 
erwise if expressions is true then the commands to the second else are executed, etc. Any 
number of else-if pairs are possible; only one endif is needed. The else part is likewise 
optional. (The words else and endif must appear at the beginning of input lines; the if 
must appear alone on its input line or after an else.) 

jobs [ -1 ] 

Lists the active jobs; the -1 option lists process id's in addition to the normal information. 

kill % job 

kill - sig %job . . . 

kill pid 

kill -sig pid . . . 

kill -1 Sends either the TERM (terminate) signal or the specified signal to the specified jobs or 
processes. Signals are either given by number or by names (as given in 
/usr/include/signal.h, stripped of the "SIG" prefix - see signal{2)). The signal names are 
listed by kill -1. There is no default, so saying just kill does not send a signal to the 
current job. If job control is supported £ind the signal being sent is TERM (terminate) or 
HUP (hangup), then the job or process is sent a CONT (continue) signal as well. 

login Terminates a login shell, replacing it with an instance of /bin/login. This is one way to 
log off, included for compatibility with sA(l). 

logout Terminates a login shell. Especially useful if ignoreeof\a set. 

newgrp 

Changes the group identification of the caller; for detsuls see newgrp{l). A new shell is 
executed by newgrp so that the ciurent shell environment is lost. 

nice 

nice + number 

nice command 

nice +number command 

The first form sets the nice (run command priority) for this shell to 4 (the default). The 
second form sets the priority to the given number. The final two forms rvm command at 
priority 4 and number respectively. The super-user may raise the priority by specifying 
negative niceness using nice -number .... Command is always executed in a sub-shell, 
and the restrictions place on commands in simple if statements apply. 

nohup [ command ] 

Without an argmnent, nohup can be used in shell scripts to cause hangups to be ignored 
for the remainder of the script. With an argument, causes the specified command to be 
nm with hangups ignored. All processes executed in the background with & are 
effectively noAup'ed. 

notify [ %job ...] 

Causes the shell to notify the user asynchronously when the status of the current (no 
argiunent) or specified jobs changes; normally notification is presented before a prompt. 
This is automatic if the shell variable notify is set. 

onintr [ - ] [ label ] 

Controls the action of the shell on interrupts. With no arguments, onintr restores the 
default action of the shell on interrupts, which is to terminate shell scripts or to return to 
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the terminal command input level. If - is specified, causes all interrupts to be ignored. If 
a label is given, causes the shell to execute a goto label when an interrupt is received or 
a child process terminates because it was interrupted. 

If the shell is running in the backgroimd and interrupts are being ignored, onintr has no 
effect; interrupts continue to be ignored by the shell and all invoked commands. 

popd [ +n ] 

Pops the directory stack, returning to the new top directory. With £in argmnent, discards 
the nth entry in the stack. The elements of the directory stack are munbered from 
starting at the top. 

pushd [ name ] [+n] 

With no argiunents, puahd exchanges the top two elements of the directory stack. Given 
a name argument, pushd changes to the new directory (using cd) and pushes the old 
current working directory (as in csw) onto the directory stack. With a ntuneric argu- 
ment, rotates the nth argument of the directory stack around to be the top element and 
changes to it. The members of the directory stack are munbered from the top starting at 
0. 

rehash Causes the internal hash table of the contents of the directories in the path vanable to be 
recomputed. This is needed if new commands are added to directories in the path while 
you are logged in. This should only be necessary if you add commands to one of your 
own directories, or if a systems programmer changes the contents of one of the system 
directories. 

repeat count command 

The specified command (which is subject to the same restrictions as the command in the 
one line if statement above) is executed count times. I/O redirections occur exactly once, 
even if count is 0. 

set 

set name 

set name=word 

set name[%ndex]=word 

set name={wordlist) 

The first form of set shows the value of all shell variables. Variables which have other 
than a single word as value print as a parenthesized word list. The second form sets 
name to the null string. The third form sets name to the single word. The fourth form 
sets the index'th component of name to word; this component must already exist. The 
finsil form sets name to the list of words in wordlist. In all cases the value is command 
and filename expanded. 

These sirguments may be repeated to set multiple values in a single set command. Note, 
however, that variable expansion happens for all argmnents before any setting occurs. 

setenv name value 

Sets the value of enviroiunent variable name to be value, a single string. The most com- 
monly used environment variables USER, TERM, and PATH are automatically imported to 
and exported from the csh variables user, term, find path; there is no need to use setenv 
for these. 

shift [ variable ] 

With no argument, the members of argv are shifted to the left, discarding orjr[l]. An 
error occurs if argv is not set or has less than two strings assigned to it. With an argu- 
ment, shift performs the same function on the specified variable. 

source name 

The shell reads commands from name. Source conmiands may be nested; if they are 
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nested too deeply the shell may run out of file descriptors. An error in a source at any 
level terminates all nested source conunands. Input during source commands is never 
placed on the history list. 

stop ( %job ...] 

Stops the current (no argimient) or specified jobs executing in the background. This com- 
mand is supported only if job control is available. 

suspend 

Causes csh to stop as if it had been sent a suspend signal. Since csh normally ignores 
suspend signals, this is the only way to suspend the shell. This command gives an error 
message if attempted from a login shell. This command is supported only if job control is 
available. 

switch {string) 
case strl: 

breaksw 

default: 

breaksw 

endsw Each case label (stri) is successively matched against the specified string which is first 
command and filename expanded. The file metsicharacters *, ?, and [...] may be used in 
the case labels, which are variable expanded. If none of the labels match before a default 
label is found, then the execution begins after the default label. Each case label and the 
default label must appear at the beginning of a line. The command breaksw causes exe- 
cution to continue after the endsw. Otherwise, control may fall through case labels and 
default labels as in C. If no label matches and there is no default, execution continues 
after the endsw. 

time [ command ] 

With no argmnent, a summary of time used by this shell and its children is printed. If an 
argument is given, the specified simple command is timed and a time summary as 
described imder the time variable is printed. If necessary, an extra shell is created to 
print the time statistic when the command completes. 

umask [ value ] 

The current file creation mask is displayed (no argmnent) or set to the specified value. 
The mask is given in octal. Common values for the mask are 002, which gives all permis- 
sions to the owner and group, and read and execute permissions to all others, or 022, 
which gives all permissions to the owner, and only read and execute permission to the 
group and all others. 

unalias pattern 

All aliases whose names match the specified pattern are discarded. Thus, all aliases are 
removed by unalias *. No error occurs if pattern matches nothing. 

unhash 

Use of the internal hash table to speed location of executed programs is disabled. 

unset pattern 

All variables whose names match the specified pattern are removed. Thus, all variables 
are removed by unset *; this has noticeably distasteful side-effects. No error occurs if 
pattern matches nothing. 

unsetenv pattern 

Removes all variables whose names match the specified pattern from the environment. 
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See also the setenv command above and printenv{l). 

wait All backgroimd jobs are waited for. If the shell is interactive, then an interrupt can dis- 
rupt the wait, at which time the shell prints names and job nmnbers of all jobs known to 
be outstanding. 

while (expression) 

end While the specified expression evaluates non-zero, the commands between the while and 
the matching end are evaluated. Break and continue may be used to terminate or con- 
tinue the loop prematurely. (The while and end must appear alone on their input lines.) 
If the input is a terminal (i.e. not a script), prompting occurs the first time through the 
loop as for the for each statement. 

%job Brings the specified job into the foreground. This is supported only if job control is avail- 
able. 

%job & 

Continues the specified job in the background. This is supported only if job control is 
available. 

specified name to the value of expression. If the expression contains "<", ">", "k," or 
"I", then at least this part of the expression must be placed within parentheses. The 
third form assigns the value of expression to the indei'th argmnent of name. Both name 
and its mdex'th component must already exist. 

The operators "*=", "+=", etc., are available as in C. White space may optionally 
separate the name from the assignment operator. However, spaces are mandatory in 
separating components of expression which would otherwise be single words. 

Specijil postfix "++" and " — " operators increment and decrement name, respectively 
(i.e. Di-|-+). 

Non-Built-In Command Execution 

When a command to be executed is not a built-in command, the shell attempts to execute the 
command via exec{2). Each word in the variable path names a directory in which the shell 
attempts to find the command (if the command does not begin with "/ ")• If neither — c nor — t is 
given, the shell hashes the names in these directories into an internal table so that an exec is 
attempted only in those directories where the command might possibly reside. This greatly 
speeds command location when a large number of directories are present in the search path. If 
this mechfinism has been turned off (via unhash), or if -c or -t was given, or if any directory 
component of path does not begin with a '/', the shell concatenates the directory name and the 
given command name to form a path name of a file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus 

(cd ; pwd) 
prints the home directory but leaves you where you were. 

cd ; pwd 

does the same thing, but leaves you in the home directory. 

Parenthesized commands are most often used to prevent chdir from affecting the current shell. 

If the file has execute permissions but is not an executable binary file, then it is assmned to be a 
shell script, and a new shell is spawned to read it. 

If there is an alias for shell then the words of the alias are inserted at the begiiming of the argu- 
ment list to form the shell commsmd. The first word of the alias should be the full path name of 
the shell (e.g. "Sshell"). Note that this is a special, late-occurring case of alias substitution, which 



Hewlett-Packard Company - 8 - Version B.l, October 1986 



CSH(l) HP-UX CSH(l) 



inserts words into the argument list without modification. 

History Substitutions 

History substitutions enable you to use words from previous commands as portions of new com- 
mands, repeat commands, repeat arguments of a previous command in the current command, and 
fix spelling mistakes in the previous command. 

History substitutions begin with an exclamation point (!). Substitutions may begin anywhere in 
the input stream, but may not be nested. The exclamation point can be preceded by a backslash 
to prevent its special meaning. For convenience, an exclamation point is passed to the parser 
imchanged when it is followed by a blank, tab, newline, equal sign or left parenthesis. Any input 
line which contains history substitution is echoed on the terminal before it is executed for 
verification. 

Commands input from the terminal which consist of one or more words are saved on the history 
list. The history substitutions reintroduce sequences of words from these saved commands into 
the input stream. The number of previous commands saved is controlled by the history variable. 
The previous command is always saved, regardless of its value. Commands are nmnbered sequen- 
tially from 1. 

You can refer to previous events by event number (such as !10 for event 10), relative event loca- 
tion (such as !-2 for the second previous event), full or partial command n£ime (such as !d for the 
last event using a command with initial character d), and string expression (such as !?niic? refer- 
ring to an event containing the characters mic). 

These forms, without fm-ther modification, simply reintroduce the words of the specified events, 
each separated by a single blank. As a special case, !! is a re-do; it refers to the previous com- 
mand. 

To select words from a command you can follow the event specification by a colon (:) and a 
designator for the desired words. The words of an input line are numbered from zero. The basic 
word designators are: 

selects the first word (i.e. the command name itself). 

n selects the nth word. 

selects the first argument. (This is equivalent to '1'.) 

$ selects the last word. 

a-b selects the range of words from a to 6. Special cases are -y, which is an abbrevi- 
ation for "word through word y", and x-, which stands for "word x up to, but 
not including, word $". 

* indicates the range from the second word to the last word. 

% used with a search sequence to substitute the immediately preceding matching 

word. 

The colon separating the command specification from the word designator can be omitted if the 
argument selector begins with a ',$,*, -, or %. 

After each word designator, you can place a sequence of modifiers, each preceded by a colon. The 
following modifiers are defined: 

h Use only the first component of a pathname by removing all following com- 

ponents. 

r Use the root file name by removing any trailing suflBx (.xxx). 

e Use the file name's trailing suffix (.xxx) by removing the root name. 
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s///r substitute the value of r for the value / in the indicated command. 

t Use only the final file name of a pathname by removmg all leading pathname 

components. 

& Repeat the previous substitution. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 

X Like q, but break into words at blanks, tabs and newlines. 

g global command; used as a prefix to cause the specified change to be made glo- 

bally (all words in the conamand are changed). 

Unless preceded by a g, the modification is applied only to the first modifiable word. You get an 
error if a substitution is attempted and cannot be completed (i.e. if you have a history bufifer of 10 
commands and ask for a substitution of !11). 

The left hand side of substitutions are not regular expressions in the sense of the HP-UX editors, 
but rather strings. Any character may be used as the delimiter in place of a slash (/); a backslash 
quotes the delimiter into the / and r strings. The character & in the right hand side is replaced 
by the text from the left. A \ quotes & also. A null / uses the previous string either from a / or 
from a contextual scan string 5 in !?s?. The trailing delimiter in the substitution may be omitted 
if a newline follows immediately, as may the trailing ? in a contextual scan. 

A history reference may be given without an event specification (e.g. !$). In this case the refer- 
ence is to the previous conunand unless a previous history reference occurred on the same line, in 
which case this form repeats the previous reference. Thus 

!?foo?" !$ 

gives the first and last arguments from the command matching "?foo?". 

A special abbreviation of a history reference occurs when the first non-blank character of an input 
line is a caret ('). This is equivalent to "!:s'", providing a convenient shorthand for substitutions 
on the text of the previous line. Thus ""Ib'lib" fixes the spelling of "lib" in the previous com- 
mand. 

Finally, a history substitution may be surroimded with curly braces { } if necessary to insulate it 
from the characters which follow. Thus, after 

Is -Id paul 
we might execute !{l}a to do 

Is -Id paula 
while !la would look for a command starting with "la". 

Quoting with Single and Double Quotes 

The quotation of strings by single quotes (') and double quotes (") can be used to prevent all or 
some of the remaining substitutions. Strings enclosed in single quotes are protected from any 
further interpretation. Strings enclosed in double quotes are still variable and command expanded 
as described below. 

In both cases the resulting text becomes (all or part of) a single word; only in one specijil case (see 
Command Substitution below) does a double-quoted string yield parts of more than one word; 
single-quoted strings never do. 

Alias Substitution 

The shell maintains a list of aliases which can be established, displayed and modified by the alias 
and unalias commands. After a command line is scanned, it is parsed into distinct commands and 
the first word of each command, left-to-right, is checked to see if it has an alias. If it does, then 
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the text which is the alias for that command is reread with the history mechanism available as 
though that command were the previous input line. The resulting words replace the commsmd 
and argxmient list. If no reference is made to the history list, then the argument list is left 
imchanged. 

Thus, if the alias for Is is Is -1, the command Is /usr maps to Is -1 /usr, leaving the argimient 
list undisturbed. Similarly, if the alias for lookup was grep !* /etc/passwd, then lookup bill 
maps to grep bill /etc/passwd. 

If an alias is found, the word transformation of the input text is performed and the aliasing pro- 
cess begins again on the re-formed input line. Looping is prevented if the first word of the new 
text is the same as the old by flagging it to prevent further aliasing. Other loops are detected and 
cause an error. 

Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can execute 

alias print 'pr \!* I Ip' 

to meike a command which uses pr(l) to print its arguments on the line printer. 

Expressions 

A nimiber of the built-in commands take expressions, in which the operators are similar to those 
of C, with the same precedence. These expressions appear in the exit, if, and while conunands. 
The following operators are available (shown in order of increasing precedence): 

1 1 && I -&==!= =^ !<=>=<>«» + ^ ♦/ % ! ( ) 

The following list shows the grouping of these operators. The precedence decreases from top to 
bottom in the list: 

* / % 
+ - 
« » 

The ==, !=, = , and ! operators compare their arguments as strings; all others operate on 
numbers. The operators = and ! are like != and ==, except that the right hand side is a pat- 
tern (containing *'s, ?'s, and instances of [...] ) against which the left hand operand is matched. 
This reduces the need for use of the switch statement in shell scripts when all that is really needed 
is pattern matching. 

Strings which begin with are considered octal nmnbers. Null or missing arguments are con- 
sidered 0. The result of all expressions are strings, which represent decimal nmnbers. It is impor- 
tant to note that no two components of an expression can appear in the same word. These com- 
ponents should be surrounded by spaces except when adjacent to components of expressions which 
are syntactically significant to the parser - &, I, <, >, (, and ). 

Also available in expressions as primitive operands are command executions enclosed in curly 
braces { } and file enquiries of the form "-/ filename", where / is one of: 

r read access 

w write access 

X execute access 

e existence 

o ownership 

z zero size 

f plain file 

d directory 
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The specified filename is command and filename expanded and then tested to see if it has the 
specified relationship to the real user. If the file does not exist or is inaccessible then all enquiries 
return false (0). Command executions succeed, returning true, if the command exits with status 
0; otherwise they fail, returning false. If more detailed status information is required then the 
conunand should be executed outside of an expression and the variable status examined. 

Control of the Flow 

The shell contains a nmnber of commands which can be used to regulate the flow of control in 
command files (shell scripts) and (in limited but useful ways) from terminal input. These com- 
mands all operate by forcing the shell to reread or skip parts of its input and, due to the imple- 
mentation, restrict the placement of some of the commands. 

The for each, switch, and while statements, as well as the if-then-else form of the if statement, 
require that the major keywords appear in a single simple command on an input line as shown 
below. 

If the shell's input is not seekable, the shell buffers up input whenever a loop is being read and 
performs seeks in this internal buffer to accomplish the rereading implied by the loop. (To the 
extent that this allows, bsickward goto's succeed on non-seekable inputs.) 

Signal Handling 

The shell normally ignores quit signals. Jobs nmning in backgrovmd mode are immime to signals 
generated from the keyboard, including hangups. Other signals have the values which the shell 
inherited from its parent. The shells handling of interrupts and terminate signals in shell scripts 
can be controlled by onintr. Login shells catch the terminate signal; otherwise this signal is 
passed on to children from the state in the shell's parent. In no case are interrupts allowed when 
a login shell is reading the file .logout. 

Command Line Parsing 

Csh splits input lines into words at blanks and tabs. The following exceptions (psirser metacharac- 
ters) are considered separate words: 



& 


ampersand; 


1 


vertical bar; 


5 


semicolon; 


< 


less-than sign; 


> 


greater-than sign; 


( 


left parenthesis; 


) 


right parenthesis; 


&& 


double ampersand; 


II 


double vertical bar; 


« 


double less-than sign; 


» 


double greater-than sign; 



The backslash (\) removes the special meaning of these parser metacharacters. A parser meta- 
character preceded by a backslash is interpreted as its ASCII value. A newline character (ASCII 
10) preceded by a backslash is equivalent to a blank. 

Strings enclosed in single or double quotes form parts of a word. Metacharacters in these strings, 
including blanks and tabs, do not form separate words. Within pairs of backslashs or quotes, a 
newline preceded by a backslash gives a true newline character. 

When the shell's input is not a terminal, the pound sign (#) introduces a comment terminated by 
a newline. 

CSH VARIABLES 

Csh maintains a set of variables. Each variable has a value equal to zero or more strings (words). 
Variables have names consisting of up to 20 letters and digits starting with a letter. The under- 
score character is considered a letter. The value of a variable may be displayed and changed by 
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using the set and unset commands. Some of the variables are boolean, that is, the shell dc 
care what their value is, only whether they are set or not. 

Some operations treat variables nimierically. The at sign (@) command permits numeric calcula- 
tions to be performed and the result assigned to a variable. The null string is considered to be 
zero, and any subsequent words of multi-word values are ignored. 

After the input line is aliased and parsed, and before each command is executed, variable expan- 
sion is performed keyed by the dollar sign ($) character. Variable expansion can be prevented by 
preceding the dollar sign with a backslash character (\) except within double quotes (") where 
substitution always occurs. Variables are never expanded if enclosed in single quotes. Strings 
quoted by single quotes are interpreted later (see Command Substitution) so variable substitution 
does not occur there until later, if at all. A dollar sign is passed unchanged if followed by a blank, 
tab, or end-of-line. 

Input/output redirections are recognized before variable expansion, and are variable expanded 
separately. Otherwise, the command name and entire argument list are expanded together. 

Unless enclosed in double quotes or given the :q modifier, the results of variable substitution may 
eventually be command and filename substituted. Within double quotes, a variable whose value 
consists of multiple words expands to a portion of a single word, with the words of the variable's 
value separated by blanks. When the :q modifier is applied to a substitution, the variable 
expands to multiple words with each word separated by a blank and quoted to prevent later com- 
mand or filename substitution. 

The following metasequences are provided for introducing variable values into the shell input. 
Except as noted, it is an error to reference a variable which is not set. 

$variable_name 

${variable_name} 

When interpreted, this sequence is replaced by the words of the value of the vari- 
able variable— name , each separated by a blank. Braces insulate variable— name 
from following characters which would otherwise be interpreted to be part of the 
variable name itself. 

If variable— name is not a csh variable, but is set in the environment, then that 
value is used. Non-csh variables cannot be modified as shown below. 

$variable^ame[selector] 

${variable_name[selector] } 

This modification allows you to select only some of the words from the 
value of variable— name . The selector is subjected to variable substitu- 
tion and may consist of a single nmnber or two numbers separated by a 
dash. The first word of a variable's value is numbered 1. If the first 
number of a range is omitted it defaults to 1. If the last member of a 
range is omitted it defaults to the total number of words in the variable 
($#variable_name). An asterisk metacharacter used as a selector selects 
all words. 

$#variable_name 
${#variable__name} 

This form gives the nimiber of words in the variable. This is useful for 

forms using a [selector] option. 

$0 This form substitutes the name of the file from which command input is 

being read. An error occurs if the filename is not known. 

Snumber 
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The modifiers 



${nuniber} 

This form is equivalent to an indexed selection from the variable argv 
($argv[mmiber]). 

This is equivalent to selecting all of argv ($£irgv[*]). 

:h, :t, :r, :q and :x may be applied to the substitutions above, as may :gh, 
:gt and :gr. If cm^ly braces { } appear in the conmiand form then the modifiers must 
appear within the braces. The current implementation allows only one : modifier on each 
$ expansion. 

The following substitutions may not be modified with : modifiers. 

$?variable name 
$ { ? v£ir iable_name } 

Substitutes the string 1 if variable name is set, if it is not. 

Substitutes 1 if the cm-rent input filename is known, if it is not. 

Substitutes the (decimal) process nmnber of the (parent) shell. 

Substitutes a line from the stsmdard input, with no further interpretation 
thereeifter. It can be used to read from the keyboard in a shell script. 

Pre-Defined and Environment Variables 

The following variables have special meaning to the shell. Of these autologout, argv, cwd, home, 
path, prompt, shell, and status are always set by the shell. Except for cwd and status, this setting 
occurs only at initialization (initial execution of csh). These variables are not modified unless 
modified explicitly by the user. 

Csh copies the HP-UX environment variable USER into the shell variable user, the environment 
variable TERM into term, the environment variable HOME into home, and PATH into path. Csh 
copies these values back into the environment whenever the csh variables are reset. 

argv This variable is set to the arguments of the csh command statement. It 

is from this variable that positional parameters are substituted, i.e. $1 is 
replaced by $argv[l], etc. 

cdpath This variable gives a list of alternate directories searched to find sub- 

directories in chdir commands. 



$?0 



$< 



cwd 



echo 



history 



home 



This variable contains the absolute pathname of your current working 
directory. Whenever you change directories (using cd), this variable is 
updated. 

This variable is set by the -x conmiand line option. If set, all built-in 
commands and their arguments are echoed to your standard output dev- 
ice just before being executed. Built-in commands are echoed before 
command and filename substitution, since these substitutions are then 
done selectively. For non-built-in commands, all expansions occm" before 
echoing. 

This variable is used to create your command history buffer and to set 
its size. If this variable is not set, you have no command history and can 
do no history substitutions. Very large values of history may nm yom- 
shell out of memory. Values of 10 or 20 are normal. All commands, exe- 
cutable or not, are saved in your command history buffer. 

This variable contains the absolute pathname to your home directory. 
Home is initialized from the HP-UX environment. The filename expan- 
sion of tilde ( ) refers to this variable. 
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Iffnoreeof 



mail 



noclobber 



noglob 



nonomatch 



notify 



path 



prompt 



shell 



If set, csh ignores end-of-file characters from input devices that arc ter- 
minals. Csh will exit normally when it encoimters the end-of-file condi- 
tion, which is control-D typed as the first character on a command line. 
Setting ignoreeof prevents your current shell from being killed by an 
accidental control-D. 

This variable contains a list of the files where csh checks for your mail. 
Cah periodically (default is 10 minutes) checks this variable after a com- 
mand completion which results in a prompt. If the variable contains a 
filename that has been modified since the last check (resulting from mail 
being put in the file), csh prints You have new mail. 

If the first word of the value of mail is numeric, that mmiber specifies a 
different mail checking intervEil in seconds. 

If multiple mail files are specified, then the shell says 
iVeiymailmfile name, where file— name is the file containing the mail. 

This variable places restrictions on output redirection to insure that files 
are not accidentally destroyed, and that commands using append redirec- 
tion (>>) refer to existing files. 

If set, filename expansion is inhibited. This is most useful in shell scripts 
which are not dealing with filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 

If set, it is no longer an error for a filename expansion to not match any 
existing files. If there is no match, the primitive pattern is returned. It 
is still an error for the primitive pattern to be malformed, i.e. 'echo [ ' 
still gives an error. 

If set, csh notifies you immediately (through your standard output dev- 
ice) of background job completions. The default is unset (indicate job 
completions just before printing a prompt). 

Each word of the path variable specifies a directory in which commands 
are to be sought for execution. A null word specifies your cm-rent work- 
ing directory. If there is no path variable then only full path names can 
be executed. When path is not set £md when users do not specify full 
pathnames, csh searches for the command through the directories . (your 
current directory), /bin, /Ibin, /usr/bin, and /usr/lbin. A csh which is 
given neither the -c nor the -t option normally hashes the contents of 
the directories in the path variable after reading .cshrc, and each time 
the path variable is reset. If new commands are added to these direc- 
tories while the shell is active, it is necessary to execute rehash for csh to 
access these new commands. 

This variable lets you select your own prompt character string. The 
prompt is printed before each command is read from an interactive ter- 
minal input. If a ! appears in the string it is replaced by the current 
command history buffer event nimiber unless a preceding \ is given. 
The default prompt is the percent sign {%) for users and the pound sign 
(#) for the super-user. 

This variable contains the name of the file in which the csh program 
resides. This variable is used in forking shells to interpret files which 
have their execute bits set, but which are not executable by the system. 
(See the description of Non- built-in Command Execution). 



Hewlett-Packard Company 



15 



Version B.l, October 1986 



CSH(l) HP-UX CSH(l) 



status This variable contains the status value retiuned by the last command. 

If the command terminated abnormally, 0200 is added to the status 
variable's value. Built-in commands which terminated abnormally 
return exit status 1, and all other built-in commands set status to 0. 

time This variable contains a ntmieric value which controls the automatic 

timing of commands. If set, then cah prints, for any conunand which 
takes more than the specified number of cpu seconds, a line of informa- 
tion to yoiu- standard output device giving user, system, and real execu- 
tion times plus a utilization percentage. The utilization percentage is the 
ratio of user plus system times to real time. This message is printed 
after the command finishes execution. 

verbose This variable is set by the -v command line option. If set, the words of 

each command are printed on the standard output device after history 
substitutions have been made. 

Command and Filename Substitution 

The remaining substitutions, command and filename substitution, are applied selectively to the 
arguments of built-in commands. This means that portions of expressions which are not 
evaluated are not subjected to these expansions. For commands which are not internal to the 
shell, the command name is substituted separately from the argiunent list. This occurs very late, 
after input-output redirection is performed, and in a child of the main shell. 

Command Substitution 

Command substitution is indicated by a command enclosed in grave accents (" ...'). The output 
from such a command is normally broken into separate words at blanks, tabs and newlines, with 
null words being discarded, this text then replacing the original string. Within double quotes, 
only newlines force new words; blanks and tabs are preserved. 

In any case, the single final newline does not force a new word. Note that it is thus possible for a 
command substitution to yield only part of a word, even if the command outputs a complete line. 

Filename Substitution 

If a word contains any of the characters *, ?, [, or {, or begins with the character , then that 
word is a candidate for filename substitution, also known as globbing. This word is then regarded 
as a pattern, and replaced with an alphabetically sorted list of file names which match the pat- 
tern. In a list of words specifying filename substitution it is an error for no pattern to match an 
existing file name, but it is not required for each pattern to match. Only the metacharacters *, ?, 
and [ imply pattern matching, while the characters and { are more like abbreviations. 

In matching filenames, the character . at the beginning of a filename or immediately following a /, 
as well as the character / itself, must be matched explicitly. The character * matches any string 
of characters, including the null string. The character ? matches any single character. The 
sequence [...] matches any one of the characters enclosed. Within the square brackets, a pair of 
characters separated by - matches any character lexically between and including the two. 

The tilde character ( ) at the beginning of a filename is used to refer to home directories. By 
itself, the tilde expands to yoiu- home directory as reflected in the value of the variable home. 
When followed by a name consisting of letters, digits and - characters, the shell searches for a 
user with that name and substitutes their home directory; thus ken might expand to 
/users/ken and ken/climach to /usr/ken/chmach. If the is followed by a character other 
than a letter or /, or appears somewhere other than at the beginning of a word, it is left undis- 
turbed. 

The metanotation a{b,c,d}e is a shorthand for "abe ace ade". Left to right order is preserved, 
with results of matches being sorted separately at a low level to preserve this order. This con- 
struct may be nested. Thus 
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j/sl/^o!dls,ls^.c 

expands to 

/usr/source/sl/oldls.c /usr/source/sl/ls.c 

whether or not these files exist, without any chance of error if the home directory for source is 
/usr/sovLTCt. Similarly, 

../{memo,*box} 

might expand to 

../memo ../box ../mbox 

(Note that "memo" was not sorted with the results of matching *box.) As a special case, {, }, 
and { } are passed imdisturbed. 

Input/Output 

The standard input and standard output of a command may be redirected with the following syn- 
tax: 

< namt 

Open file namt (which is first variable, command and filename expanded) as the 
standard input. 

<< word 

Read the shell input up to a line which is identical to word. Word is not sub- 
jected to variable, filename or command substitution, and each input line is com- 
pared to word before any substitutions are done on this input line. Unless a quot- 
hig \, ", '> or ' appears in word., variable and command substitution is performed 
on the intervening lines, allowing \ to quote $, \ and \ Conomands which are 
substituted have all blanks, tabs, and newlines preserved, except for the final 
newline which is dropped. The resultant text is placed in an anonymous tem- 
porary file which is given to the command as standard input. 

> r%amt 

>! namt 

>k namt 

>&! namt 

The file namt is used as standard output. If the file does not exist then it is 
created; if the file exists, it is tnmcated, and its previous contents are lost. 
If the variable noclobbtr is set, then the file must not exist or be a character spe- 
cial file (e.g. a terminal or /dtv/nuU) or an error results. This helps prevent 
accidental destruction of files. In this case the exclamation point (!) forms can be 
used to suppress this check. 

The forms involving the ampersand character (&) route the standard error into 
the specified file as well as the standard output. Namt is expanded in the same 
way as < input filenames are. 

>> namt 
»k namt 
»l namt 
>>&! namt 

Uses file namt as standard output like >, but appends output to the end of the 
file. If the variable noclobbtr is set, then it is an error for the file not to exist 
imless one of the ! forms is given. Otherwise, it is similar to >. 
A command receives the environment in which the shell was invoked as modified by the input- 
output parameters and the presence of the command in a pipeline. Thus, imlike some previous 
shells, commands executed from a shell script have no access to the text of the commands by 
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default; rather they receive the original standard input of the shell. The << mechanism should 
be used to present inline data. This permits shell scripts to function as components of pipelines 
and allows the shell to block read its input. Note that on systems which do not support job con- 
trol, the default standard input for a command run in background mode is modified to be the 
empty file /dev/null. 

Diagnostic output may be directed through a pipe with the standard output. Simply use the form 
"\ k," rather than just "I". 

CSH UTILITIES 

File Name Completion 

In typing file names as arguments to commands, it is no longer necessary to type a complete 
name, only a imique abbreviation is necessary. When you want the system to try to match your 
abbreviation, press your ESCAPE key. The system then completes the filename for you, echoing 
the full name on your terminal. If the abbreviation doesn't match an available filename, the 
terminal's bell is soimded. The file name may be partially completed if the prefix matches 
several longer file names. In this case, the name is extended up to the ambiguous deviation, 
and the bell is sounded. 

File name completion works equally well when other directories are addressed. In addition, the 
tilde ( ) convention for home directories is understood in this context. 

Viewing a File or Directory List 

At any point in t3T>ing a command, you may request "what files are available" or "what files 
match my current specification". Thus, when you have typed: 

% cd speech/data/bench/fritz/ 

you may wish to know what files or subdirectories exist (in speech/data/bench/fritz), 
without aborting the command you axe typing. Typing control-D at this point lists the files 
available. The files are listed in multicolumn format, sorted colunm-wise. Directories and 
executable files are indicated with a trailing / and *, respectively. Once printed, the command 
is re-echoed for you to complete. Additionally, you may want to know which files match a 
prefix, the current file specification so far. If you had typed: 

% cd speech/data/bench/fr 

followed by a control-D, all files and subdirectories whose prefix was "fr" in the directory 
speech/data/bench would be printed. Notice that the example before was simply a degen- 
erate case of this with a null trailing file name. (The null string is a prefix of all strings.) Notice 
also that a trailing slash is required to pass to a new sub-directory for both file name comple- 
tion and listing. Note that the degenerate case 

% *D 

prints a full list of login names on the current system. 

Command Name Recognition 

Command name recognition and completion works in the same manner as file Ueime recognition 
sind completion above. The ciurrent value of the environment variable PATH is used in search- 
ing for the command. For example 

% newa [Escape] 
might expand to 

% newEiliases 
Also, 

% new [Control]-[D] 
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lists all commands (along PATH) that begin with "new". As an option, if the shell variable 
iistpathnum is set, then a number indicating the index in PATH is printed next to each command 
on a [Control]- [D] listing. 

Autologout 

A new shell variable has been added called autologout. If the terminal remains idle (no character 
input) at the shell's top level for a number of minutes greater than the value assigned to autolo- 
gout, you are automatically logged oflF. The autologout feature is temporarily disabled while a 
command is executing. The initial value of autologout is 60. If imset or set to 0, autologout 
is entirely disabled. 

Command Line Control 

A 'R will re-print the current command line; *W will erase the last word entered on the current 
command line. 

Sanity 

The shell now restores your terminal to a sane mode if it appears to return from some command 
m raw, cbreak, or noecho mode. 

Saving Your History Buffer 

Csh has the facility to save your history list between login sessions. If the shell variable savehist 
is set to a niunber, then that nimiber of command events from your history list Eire saved. For 
example, placing the line 

set history=10 savehist=10 

in your .cshrc file maintains a history buffer of length 10 and saves the entire list when you 
logout. When you log back in, the entire buffer is restored. The commands are saved in the file 
.history in your login directory. 

FILES 

/.cshrc a csh script sourced (executed) at the beginning of execution by each shell. 

/.login a csh script sourced (executed) by login shell, after .cshrc at login. 

/.logout a csh script sourced (executed) by login shell, at logout. 

/etc/passwd source of home directories for name. 

/bin/sh standard shell, for shell scripts not starting with a #. 

/etc/csh.login a csh script sourced (executed) before /.cshrc and /.login when starting a 

csh login (analogous to /etc /profile in the Bourne shell). 

/tmp/sh* temporsuy file for <<. 

LIMITATIONS 

Words can be no longer than 1024 characters. 

The system limits argument lists to 10240 characters. 

The nmnber of argiunents to a command which involves filename expansion is limited to 1/6'th 

the nimiber of characters allowed in an argument list. 

Command substitutions may substitute no more characters than are allowed in an argument list. 

To detect looping, the shell restricts the number of alias substitutions on a single line to 20. 

HARDWARE DEPENDENCIES 

Series 200, 300, 500 

Job control is not supported. 

AUTHOR 

Csh was developed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 
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SEE ALSO 

sh(l), access(2), exec(2), fork(2), pipe(2), \ima8k(2), wait(2), tty(7), a.out(4), environ(5). 

BUGS 

On those systems which support job control, when a command is restarted from a stop, cah prints 
the directory it started in if it is different from the ciirrent directory; this can be misleading (i.e. 
wrong) as the job may have changed directories internally. 

Shell built-in functions are not stoppable/restartable. Command sequences of the form "a ; b ; c" 
are also not handled gracefully when stopping is attempted. If you interrupt b, the shell then 
immediately executes c. This is especially noticeable if this expansion results from an aliaa. It 
suffices to place the sequence of commands in ( )'s to force it into a subshell, i.e. ( a ; b ; c ). 

Because of the signal handling required by csh, interrupts are disabled just before a command is 
executed and restored as the command begins execution. There may be a few seconds delay 
between when a command is given and when interrupts are recognized. 

Control over tty output after processes are started is primitive; perhaps this will inspire someone 
to work on a good virtual terminal interface. In a virtual terminal interface much more interest- 
ing things could be done with output control. 

Ahas substitution is most often used to clumsily simulate shell procedures; shell procediu-es should 
be provided rather than aliases. 

Commands within loops, prompted for by ?, are not placed in the history list. Control structure 
should be parsed rather than being recognized as built-in commands. This would allow control 
commands to be placed anywhere, to be combined with I , and to be used with & and ; metasyn- 
tax. 

It should be possible to use the : modifiers on the output of command substitutions. All and more 
than one : modifier should be sillowed on $ substitutions. 

Your terminal type is only examined the first time you attempt recognition. 

To list all commands on the system along PATH, enter [SPACE]-(CNTL]-[D]. 

The csh metasequence ! does not work. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

csplit - context split 

SYNOPSIS 

csplit [-s] [-k] [-f prefix] file argl [. . . argn] 

DESCRIPTION 

Csplit reads file and separates it into n+1 sections, defined by the Eirguments argl. . . argn. By 
default the sections are placed in xxOO . . . xxn (n may not be greater than 99). These sections 
get the following pieces oi file: 

00: From the start of file up to (but not including) the line referenced by argl . 

01: From the line referenced by argl up to the line referenced by arg2. 



n+1: From the line referenced by argn to the end of file. 

If the file argument is a - then standard input is used. 

The options to csplit are: 

-8 Csplit normally prints the character counts for each file created. If the -8 option 

is present, csplit suppresses the printing of all character counts. 

-k Csplit normsilly removes created files if an error occurs. If the -k option is 

present, csplit leaves previously created files intact. 

-f prefix If the -f option is used, the created files are named prefixOO . . . prefixn. The 

default is xxOO . . . xxn. 

The arguments {argl . . . argn) to csplit can be a combination of the following: 

jrexpj A file is to be created for the section from the current line up to (but not includ- 

ing) the line containing the regular expression rexp. The current line becomes 
the line containing rexp. This argument may be followed by an optional + or - 
some number of lines (e.g., /Page/-5). 

%rexp% This argument is the same as /rexp/, except that no file is created for the section. 

Inno A file is to be created from the current line up to (but not including) Inno. The current 
line becomes Inno. 

{num} Repeat argument. This argument may follow any of the above arguments. If it follows a 
rexp type argimient, that argmnent is applied num more times. If it follows Inno, the 
file will be split every Inno lines {num times) from that point. 

Enclose all rexp type arguments that contain blanks or other characters meaningful to the Shell in 
the appropriate quotes. Regular expressions may not contain embedded new-lines. Csplit does 
not affect the original file; it is the users responsibility to remove it. 

EXAMPLES 

csplit -f cobol file '/Procedure division/' /par5./ /parl6./ 

This example creates four files, coboIOO . . . coboIOS. After editing the "split" files, they can be 
recombined as follows: 

cat cobolO[0-3] > file 

Note that this example overwrites the original file. 

csplit -k file 100 {99} 
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This example would split the file at every 100 lines, up to 10,000 lines. The -k option causes the 
created files to be retained if there are less than 10,000 lines; however, an error message would still 
be printed. 

csplit -k prog.c '%main(%' '/'}/+l' {20} 

Assuming that prog.c follows the normal C coding convention of ending routines with a } at the 
beginning of the line, this example will create a file containing each separate C routine (up to 21) 
in prog.c. 

SEE ALSO 

ed(l), sh(l), regexp(5). 

DIAGNOSTICS 

Self explanatory except for: 

arg - out of range 
which means that the given argument did not reference a line between the current position £ind 
the end of the file. 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

ct - spawn getty to a remote terminal (call terminal) 

SYNOPSIS 

ct [ -wn ] [ -h ] [ -V ] [ -sspeed ] telno ... 

DESCRIPTION 

Ct dials the phone number of a modem that is attached to a terminal, and spawns a getty process 
to that terminal. Telno is a telephone nimiber, with equal signs for secondary dial tones and 
minus signs for delays at appropriate places. If more than one telephone number is specified, ct 
will try each in succession imtil one answers; this is useful for specifying alternate dialing paths. 

Ct will try each line listed in the file /usr/lib/uucp/L-devices until it finds an available line 
with appropriate attributes or nms out of entries. If there ase no free lines, ct will ask if it should 
wait for a line, and if so, for how many minutes it should wait before it gives up. Ct will continue 
to try to open the dialers at one-minute intervals imtil the specified limit is exceeded. The dialo- 
gue may be overridden by specifying the -wn option, where n is the maximmn mmaber of 
minutes that ct is to wait for a line. 

Normally, ct will hang up the cinrent line, so that that line can answer the incoming call. The -h 
option will prevent this action. If the -v option is used, ct will send a nmning narrative to the 
standard error output stream. 

The data rate may be set with the -s option, where speed is expressed in baud. The default rate 
is 300. 

After the user on the destination terminal logs out, ct prompts. Reconnect? If the response 
begins with the letter n the line will be dropped; otherwise, getty will be started again and the 
login: prompt will be printed. 

Of coiu-se, the destination terminal must be attached to a modem that can answer the telephone. 



FILES 



/usr/adm/ctlog 
/usr/lib/uucp/L-devices 



SEE ALSO 

cu(l), getty(lM), login(l), uucp(l). 
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NAME 

ctags - create a tags file 

SYNOPSIS 

ctags [ -xvFBatwu ] names... 

DESCRIPTION 

Ctags makes a tags file for ez(l) (or vt(l)) from the specified C, Pascal and Fortran sources. A 
tags file gives the locations of specified objects (for C, functions, macros with argments, and 
typedefe; Pascal, procedures, programs and functions; FORTRAN, subroutines, progams and functions) 
in a group of files. Each line of the tags file contains the object name, the file in which it is 
defined, and an address specification for the object definition. All objects except C typedefs are 
searched with a pattern, typedefs with a line number. Specifiers are given in separate fields on the 
line, separated by blanks or tabs. Using the tags file, ex can quickly find these objects' definitions. 

-X causes ctags to print a simple function index. This is done by assembling a list 

of function names, file names on which each function is defined, the line niunbers 
where each function name occurs, and the text of each line. The list is then 
printed on the standard output. No tags file is created or changed. 

-V produces a page index on the standard output. This listing contains the function 

name, file name, and page niunber within that file (assiuning 56 line pages to 
match pr(l)). Since the output will be sorted into lexicographic order, it may be 
desired to run the output through sort -f. Sample use: 

ctags -V files I sort -f > index 

pr index files 

Files whose name ends in .c or .h are assmned to be C source files and are searched for C routine 
and macro definitions. Others are first examined to see if they contain any Pascal or Fortran rou- 
tine definitions; if not, they are processed again looking for C definitions. 

Other options axe: 

-F use forward searching patterns (/.../) (default). 

-B use backward searching patterns (?...?). 

-a add the information from the files to the tags file. Unlike re-building the tags file 

from the original files, this can cause the same s3Tnbol to be entered twice in the 
tags file. This option should be used with caution suid then only in very special 
circumstances. 

-t create tags for typedefs. 

-w suppressing warning diagnostics. 

-u causing the specified files to be updated in tags, that is, all references to those 

files are deleted, and the new values are added to the file as in -a above. 
(Beware: this option is implemented in a way which is rather slow; it is usually 
faster to simply rebuild the tags file.) 

The tag main is treated specially in C programs. The tag formed is created by prepending M to 
the name of the file, with a trailing .c removed, if any, and leading pathname components also 
removed. This makes use of ctags practical in directories with more than one program. 

RETURNS 

Too many entries to sort. 

An attempt to get £idditionaI heap space failed; the sort could not be performed. 

Duplicate entry in file file, line line: name. 
Second entry ignored. 
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The same name was detected twice in the same file. A tags entry was made only for the 
first name found. 

Duplicate entry in files filel and file2: name (Warning only). 

The same name was detected in two diiferent files. A tags entry was made only for the 
first name foimd. 

WARNINGS 

Recognition of functions, subroutines and procedures for FORTRAN and Pascal is done in a 
very simple way. No attempt is made to deal with block structiu-e; if there are two Pascal pro- 
cedures in different blocks with the same name a warning message will be generated. 

The method of deciding whether to look for C or Pascal and FORTRAN functions is an approxi- 
mation and can be fooled by imusual programs. 

It does not know about #ifdefs and Pascal types. 

It relies on the input being well formed to detect typedefs. 

Use of -tx shows only the last line of typedefs. 

^^(l) is naive about tags files with several identical tags; it simply chooses the first entry its 
(non-linear) search finds with that tag. Such files can be created with either the -u or -a options 
or by editing a tags file. 

If more than one (fimction) definition appears on a single line, only the first definition will be 
indexed. 

AUTHOR 

Ctags was developed by the University of California, Berkeley. 

FILES 

tags output tags file 

OTAGS temporary used by -u 

SEE ALSO 

ex(l), vi(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

cu - call another (UNIX) system; terminal emulator 

SYNOPSIS 

cu [-sspeed] [-Uine] [-h] [-q] [-t] [-d] [-e|-o] [-m] [-n] telno | systemname | 
dir 

DESCRIPTION 

Cu calls up another system, which will usually be a UNIX operating system, but may be a termi- 
n£il or a non-UNIX operating system. It manages an interactive conversation with possible 
transfers of ASCII files. Cu accepts the following options and arguments. 

-aspeed Specifies the transmission speed (110, 150, 300, 600, 1200, 2400, 3600, 4800, 7200, 

9600, 19200). The default value is 300. 

When using a direct-connect line, the -s option has no effect. The first line 
which matches the -1 option is used, and its speed is taken from L-devices. 

-Uine Specifies a device name to use as the communication line. This can be used to 

override searching for the first available line having the right speed. When the -1 
option is used without the -s option, the speed of a line is taken from the file 
/usr/lib/uucp/L-devices. When the -I and -s options are used simultane- 
ously, cu will search the L-devices file to check if the requested speed for the 
requested line is available. If so, the connection will be made at the requested 
speed; otherwise an error message will be printed and the call will not be made. 
The specified device is generally a directly connected asynchronous line (e.g., 
/dev/ttyab). In this case a phone nimiber is not required but the string dir can 
be used to specify that a dialer is not required. If the specified device is associ- 
ated with an auto dialer, a phone niunber must be provided. 

-h Emulates local echo, supporting csills to other computer systems which expect 

terminals to be set to half-duplex mode. 

-q Invokes the use of ENQ/ACK handshake. (Remote sends ENQ, cu sends ACK.) 

-t Used when dialing an ASCII terminal which has been set to auto answer. 

Appropriate mapping of carriage- return to carriage- return-line- feed pairs is set. 

-d Causes diagnostic traces to be printed. 

-e(— o) Designates that even (odd) parity is to be generated for data sent to the remote. 

-m Designates a direct line which has modem controls. The modem controls are to 

be ignored by cu. 

-n Will request the phone number to be dialed from the user rather than taking it 

from the command line. 

telno When using an automatic difiler, the argument is the telephone number with 

equal signs for secondary dial tone or minus signs for delays, at appropriate 
places. 

systemname A uucp system name may be used rather than a phone number; in this case, cu 
will obtain an appropriate direct line or phone nmnber from 
/u8r/lib/uucp/L.8ys (the appropriate baud rate is also read along with phone 
numbers). Cu will try each phone niunber or direct line for systemname in the 
L.sys file until a connection is made or all the entries are tried. 

dir Using dir ens\u-es that cu will use the line specified by the -1 option. 

After making the connection, cu runs as two processes: the transmit process reads data from the 
standard input and, except for lines beginning with ~, passes it to the remote system; the receive 
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process accepts data from the remote system and, except for lines beginning with ~, passes it to 
the standard output. Normally, an automatic DC3/DC1 protocol is used to control input from the 
remote so the buffer is not ovemm. Prompt handshaking can be used to control transfer of 
ASCII files to systems that have no type-ahead capability but require data to be sent only after a 
prompt is given. This is described in detail below. Lines beginning with ~ have special meanings. 

The transmit process interprets the following: 

~. and ~.. terminate the conversation. On a hardwired line (only), ~. sends several EOF 

characters to log out the session; ~.. will suppress the EOF sequence. In general 
the remote hardwired machine will be unaware of the disconnect if ".. is used. ~. 
and ~.. do not differ for dialup connections. 

~! escape to an interactive shell on the local system. 

~lcmd. . . run cmd on the local system (via sh -c). 

~& similar to ~! but kill the receive process, restarting it upon return from the shell. 

This is useful for invoking sub-processes that read from the commimication line, 
where the receive process would be otherwise competing for input. 

~&.cmd. . . run cmd on the local system (via sh -c) and kill the receive process, restarting it 

later. 

~$cmd. . . run cmd locally and send its output to the remote system. 

~%cd change the directory on the local system. NOTE: ~!cd will cause the com- 

mand to be run by a sub-shell; probably not what was intended. 

~%take from [ to ] 

copy file from (on the remote system) to file to on the local system. If to is 
omitted, the from argument is used in both places. 

~%put from [ to ] 

copy file from (on local system) to file to on remote system. If to is omitted, the 
from argument is used in both places. 

send the line ~. . . to the remote system. If you use c« on the remote system to 
access a third remote system, send .to cause the second remote cu to exit. 

~%break transmit a BREAK to the remote system. 

~%nostop toggles between DC3/DC1 input control protocol and no input control. This is 

useful in case the remote system is one which does not respond properly to the 
DC3 and DCl characters. 

~%<file sends the contents of the local file to the remote system using prompt 

handshaking. The specified file is read a line at a time, and each line is sent to 
the remote system when the prompt sequence is received. If no prompt is 
received by the time the prompt timeout occm-s, the line is sent ans^way. If 
the timeout is set to seconds, or if the first character in the prompt sequence is 
a null character (*@), the handshake will always appear to be satisfied immedi- 
ately, regardless of whether or not the remote system generates a prompt. This 
capability is intended mainly to facilitate transfer of ASCII files from HP-UX to 
an HP3000 system nmning MPE. This is usually accomplished by running the 
MPE utility FCOPY, and giving the command "from=;to=destfile;new" and 
then nmning the cu input diversion to send the file to FCOPY, which saves it in 
"destfile." This facility may also be useful with other systems, an HPIOOO run- 
ning RTF, for example. 

~%8etpt n this specifies the number of seconds to wait for a prompt before giving up. The 

default is 2 seconds. Specifying a timeout of seconds will disable handshaking, 
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i.e., handshake will appear to complete immediately. 

~%8etp8 xy set the handshake prompt to the characters xy. The default is DCl. The 
prompt may be any one or two characters. A control character X, i.e., Control- 
X, is specified with a caret (ASCII 94) preceding the character, i.e., "X. A null 
character may be specified with *@. (A null first character in the prompt 
implies a "null" prompt, which always appears to be satisfied.) A caret is 
specified by * '. 

~%>[>]/t/e divert output from the remote system to the specified file imtil another ~%> 
command is given. When an output diversion is active, typing ~%> will ter- 
minate it, and ~%> anotherfile will terminate it and begin a new one. The out- 
put diversion remains active through a ~& subshell, but unpredictable results 
can occur if input/output diversions are intermixed with ~%take or ~%put. 
The ~%» command will append to the named file. Note that these commands, 
which are interpreted by the transmit process, are unrelated to the ~> com- 
mands described below, which are interpreted by the receive process. 

If the implementation supports HP-UX job control (see cs/»(l)), the following additional command 
is available: 

~susp Suspend the cu session. Sttsp is the suspend character that was in use when cu 

was invoked (usually *Z) (see stty{l).) 

The receive process normally copies data from the remote system to its standard output. A line 
from the remote that begins with ~> initiates an output diversion to a file. The complete 
sequence is: 

->[>]: file 

zero or more lines to be written to file 

~> 

Data from the remote is diverted (or appended, if >> is used) to file. The trailing ~> terminates 
the diversion. 

The use of ~%put requires stty{l) and cat{l) on the remote side. It £ilso requires that the 
current erase and kill characters on the remote system be identical to the current ones on the local 
system. Backslashes are inserted at appropriate places. 

The use of ~%take requires the existence of echo{l) and caf(l)-on the remote system. Also, stty 
tabs mode should be set on the remote system if tabs are to be copied without expansion. 

When cu is used on system X to connect to system Y and subsequently used on system Y to con- 
nect to system Z, commands on system Y can be executed if ~~ is used. For example, uname can 
be executed on Z, X, and Y as follows: 

imame 

Z 

"'.uname 

X 

~~!imame 

Y 

In general, ~ causes the command to be executed on the original machine; causes the command 
to be executed on the next msw;hine in the chain. 

EXAMPLES 

To dial a system whose number is 9 201 555 1212 using 1200 baud: 
cu -81200 9=2015551212 
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If the speed is not specified, 300 is the default value. 

To login to a system connected by a direct line: 
cu -1/dev/ttyXX dir 

To dial a system with the specific line and a specific speed: 
cu -81200 -1/dev/ttyXX dir 

To dial a system using a specific line: 

cu -1/dev/culXX 2015551212 

To use a system name: 
cu YYYZZZ 

To connect directly to a modem: 

cu -1/dev/culXX -m dir 

FILES 

/usr/lib/uucp/L.sys 
/usr/lib/uucp/L-devices 
/usr/spool/uucp/LCK. . (tty-device) 
/dev/null 

SEE ALSO 

cat(l), ct(l), echo(l), stty(l), imjune(l), uucp(l). 

DIAGNOSTICS 

Ebdt code is zero for normal exit, non-zero (various values) otherwise. 

WARNINGS 

Cu buffers input internally. 

There is an artificial slowing of transmission by cu during the ~%put operation so that loss of 
data is unlikely. 

AUTHOR 

Cu was developed by AT&T and HP. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

cut - cut out selected fields of each line of a file 

SYNOPSIS 

cut -clist [filel file2 ...] 

cut -flist [-dchar] [-s] [filel file2 ...] 

DESCRIPTION 

Use cut to cut out columns from a table or fields from each line of a file; in data base parlance, it 
implements the projection of a relation. The fields as specified by list can be fixed length, i.e., 
character positions as on a pimched card (-c option), or the length can vary from line to line and 
be marked with a field delimiter character like tab (-f option). Cut can be used as a filter; if no 
files are given, the standard input is used. 

The meanings of the options are: 

list A comma-separated list of integer field nmnbers (in increasing order), with 

optional - to indicate ranges as in the -o option of nroff/troff for page ranges; 
e.g., 1,4,7; 1-3,8; -5,10 (short for 1-5,10); or 3- (short for third through last 
field). 

-clist The list following -c (no space) specifies character positions (e.g., -cl-72 would 

pass the first 72 characters of each line). 

—{list The list following -f is a list of fields assiuned to be separated in the file by a del- 

imiter character (see -d ); e.g., -fl,7 copies the first and seventh field only. 
Lines with no field delimiters will be passed through intact (useful for table sub- 
headings), unless -8 is specified. 

-dchar The character following -d is the field delimiter (-f option only). Default is tab. 

Space or other characters with special meaning to the shell must be quoted. 

-8 Suppresses lines with no delimiter characters in case of -f option. Unless 

specified, lines with no delimiters will be passed through imtouched. 

Either the — c or — f option must be specified. 

Hints 

Use grep{l) to make horizontal "cuts" (by context) through a file, or poate(l) to put files together 
column- wise (i.e., horizontally). To reorder columns in a table, use cut and paste. 

Cut does not expand tabs. Input should be piped through expand(l) if tab expansion is required. 

EXAMPLES 

cut -d: -fl,5 /etc/passwd 

mapping of user ID to names 

name= ^ who am i I cut -fl -d" " ^ 

to set name to current login name. 

DIAGNOSTICS 

line too long A line can have no more than 1023 characters or fields. 

bad list for c // option 

Missing — c or — f option or incorrectly specified list. No error occurs if a line has 
fewer fields than the list calls for. 

no fields The list is empty. 

SEE ALSO 

grep(l), paste(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

cxref - generate C program cross-reference 

SYNOPSIS 

cxref [ options ] files 

DESCRIPTION 

Cxref analyzes a collection of C files and attempts to build a cross-reference table. Cxref utilizes a 
special version of cpp to include #define'd information in its symbol table. It produces a listing 
on standard output of all symbols (auto, static, and global) in each file separately, or with the -c 
option, in combination. Each symbol contains an asterisk (*) before the declaring reference. 

In addition to the -D, -I and -U options (which are identical to their interpretation by cc(l)), 
the following options are interpreted by care/: 

-c Print a combined cross-reference of all input files. 

-w<num> Width option, which formats output no wider than <num> (decimal) columns. 

This option defaults to 80 if <num> is not specified or is less than 51. 

-o file Direct output to the named file. 

-s Operate silently; does not print input file names. 

-t Format listing for 80-column width. 

HARDWARE DEPENDENCIES 

Series 200, Series 300, Series 500 

Cxref uses a special version of the C compiler front end. The size of the internal compiler 
tables can be adjusted by using the -Wc and -N options, as described in the memual page 
for cc(l). 

FILES 

/usr/lib/xcpp special version of C-preprocessor. 

/usr/lib/xpass special version of C compiler front end. 

SEE ALSO 

cc(l). 

DIAGNOSTICS 

Error messages are imusually cryptic, but usually mean that you carmot compile these files, any- 
way. 

BUGS 

Carre/ considers a formal argmnent in a if= define macro definition to be a declaration of that sym- 
bol. For example, a program that ifincludes ctype.h will contain many declarations of the vari- 
able c. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

date - print and set the date 

SYNOPSIS 

date [ nmiddhhnmi[yy] | [ +format ] 

DESCRIPTION 

If no al-gument is given, or if the argxunent begins with +, the current date and time are printed. 
Otherwise the ciurent date is set, provided you are super-user. The first mm is the month 
nimiber; dd is the day number in the month; hh is the hour number (24 hour system); the second 
mm is the minute number; yy is the last 2 digits of the year nimiber and is optional. For exam- 
ple: 

date 10080045 

sets the date to Oct 8, 12:45 a.m. The current year is the default if no year is mentioned. The 
system operates in GMT. Date takes care of the conversion to and from local standard and day- 
light time by using the TZ environment variable. The rules applied are the converse of the rules 
described in ctime{3C). Inspection of the form of the TZ vEiriable will determine the setting of 
the tz—dsttime variable if gettimeofday{2) is supported on a given system. Only no conversion 
and USA standard dayUght conversion are defined for this field. Other conversions defined by TZ 
will be treated as no conversion for this purpose. 

Attempting to set the date backwsirds generates a warning, and requires an extra confirmation 
from the (super-)user. 

If the argiunent begins with +, the output of date is under the control of the user. The format 
for the output is similar to that of the first argument to prmf/( 3S). Nmneric output fields are of 
fixed size (zero padded if necessary). Each field descriptor is preceded by % and will be replaced 
in the output by its corresponding value. A single % is encoded by %%. All other characters are 
copied to the output without change. The string is always terminated with a new-line character. 

Date writes an accounting record on the file /etc/wtmp. 

Field Descriptors: 

n insert a new-line character 

t insert a tab character 

m month of yesir - 01 to 12 

d day of month - 01 to 31 

y last 2 digits of year - 00 to 99 

D date as mm/dd/yy 

H hour - 00 to 23 

M minute - 00 to 59 

S second - 00 to 59 

T time as HH:MM:SS 

j day of year - 001 to 366 

w day of week - Sunday = 

a abbreviated weekday name - Sun to Sat 

W full weekday name - Sunday to Saturday 

h abbreviated month - Jan to Dec 

F full month name - January to December 

r time in a.m. /p.m. notation 

z time zone n£ime from TZ variable in user's environment 

The full or abbreviated month name find full or abbreviated weekday name are spelled according 
to user's native language as defined by the LANG variable, see enwron(5). 
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If there is no argument, the current date and time are printed according to the D_T_FMT string 
(see /anj/m/o (3C)) that corresponds to the current value of the variable LANG in the user's 
environment. If the LANG variable is not set, ctime{3C) is used to format the date. 

HARDWARE DEPENDENCIES 

Series 500 

Do not change the date and/or time in the BASIC language system if your machine also 
nms HP-UX. The two operating systems' date and tune are incompatible. 

EXAMPLE 

For example: 

date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 

would have generated the following as output: 

DATE: 08/01/76 
TIME: 14:45:05 

FILES 

/etc/wtmp 

SEE ALSO 

ctime(3C), langinfo(3C), printf(3S), environ(5). 

DIAGNOSTICS 

No permission if you are not the super-user and you try to change the date; 

bad conversion if the date set is syntactically incorrect; 

bad format character 

if the field descriptor is not recognizable. 

WARNING 

It is a bad practice to change the date while the system is running multi-user. 

AUTHOR 

Date was developed by AT&T and HP. 

INTERNATIONAL SUPPORT 

8-bit data, messages. 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily it operates on decim£il integers, but 
one may specify an input base, output base, and a number of fractional digits to be maintained. 
(See 6c(l), a preprocessor for dc that provides infix notation and a C-lLke syntax that implements 
functions. Be also provides reasonable control structures for programs.) The overall structure of 
dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from that file 
until its end, then from the standard input. An end of file on standard input or the q command 
stop dc. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an unbroken 
string of the digits 0-9 or A-F. It may be preceded by an imderscore (_) to 
input a negative nimiber. Numbers may contain decimal jwints. 

The top two values on the stack are added (+), subtrsicted (-), multiplied (*), 
divided (/), remaindered (%), or exponentiated ('). The two entries are popped 
off the stack; the result is pushed on the stack in their place. Any fractional part 
of an exponent is ignored and a warning generated. The remainder is calculated 
according to the current scale factor; it is not the integer modulus function. 7 % 
3 yeilds .1 (one tenth) if scale is 1 because 7 / 3 is 2.3 with .1 as the remainder. 

sx The top of the stack is popped and stored into a register named i, where x may 

be any character. If the s is capitalized, x is treated as a stack and the value is 
pushed on it. 

\x The value in register x is pushed on the stack. The register x is not altered. All 

registers start with zero value. If the 1 is capitalized, register x is treated as a 
stack and its top value is popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. P 

interprets the top of the stack as an ASCII string, removes it, and prints it. 

f All vEilues on the stack are printed. 

q exits the progrsim. If executing a string, the recursion level is popped by two. If 

q is capitalized, the top value on the stack is popped and the string execution 
level is popped by that value. 

X treats the top element of the stack as a character string find executes it as a 

string of dc conunands. 

X replaces the nmnber on the top of the stack with its scale factor. 

[ ... ] puts the bracketed ASCII string onto the top of the stack. Strings may be nested 

by using nested pairs of brackets. 

<x >x =z \<x \>x \=x 

The top two elements of the stsick are popped and compared. Register x is evaluated if 
they obey the stated relation. 

V replaces the top element on the stack by its square root. Any existing fractioneil part of 

the argmnent is t£iken into accoimt, but otherwise the scale factor is ignored. 
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! interprets the rest of the Ime as an HP-UX system command, (unless the next character is 

<, >, or =, in which case appropriate relational operator above is used). 

c All values on the stack are popped. 

i The top value on the stack is popped £ind used as the number radix for further input. 

I pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix for further output. See 

below for notes on output base. 

O pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non-negative scale factor: the 

appropriate nimiber of places are printed on output, and maintained during multiplication, 
division, and exponentiation. The interaction of scale factor, input base, and output base 
will be reasonable if all are changed together. 

K pushes the scale factor on the top of the stack. 

z The stack level is pushed onto the stack. 

Z replaces the ninnber on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) and executed. 

; : are used by be for array operations. Y generates debugging output for dc itself. 

The input base may be any number, but only the digits 0-9 and A-F are available for input, thus 
limiting the usefulness of bases outside the range 1-16. All 16 possible digits may be used in any 
base; they always take their conventional values. 

The output base may be any nmnber. Bases in the range of 2-16 generate the "usual" results, 
with the letters A-F representing the values from 10 through 16. Bases and 1 generate a string 
of I's whose length is the value of the number. Base -1 generates a similar string consisting of 
d's. Other bases have each "digit" represented as a (multi-digit) decimal mmiber giving the ordi- 
nal of that digit. Each "digit" is signed for negative bases. "Digits" axe separated by spaces. 
Given the definition of output base, the command Op will always yield "10" (in a representation 
appropriate to the base); Ol-p yields useful information about the output base. 

EXAMPLE 

This example prints the first ten values of n! (n factorial): 

[lal-|-dsa*plalO>y]sy 

Osal 

lyx 

SEE ALSO 

bc(l). 

DIAGNOSTICS 

X is unimplemented where i is an octal number. 

stack empty when there are not enough elements on the stack to do what was asked. 

Out of spaee when the free list is exhausted (too many digits). 

Out of headers when there are too many numbers being kept aroimd. 

Out of pushdown When there are too many items on the stack. 

Nesting Depth when there are too many levels 
of nested execution. 
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NAME 

dd - convert, reblock, translate, and copy a (tape) file 

SYNOPSIS 

dd [option=value] ... 

DESCRIPTION 

Dd copies the specified input file to the specified output with possible conversions. The stsmdard 
input and output are used by default. The input and output block size may be specified to take 
advantage of raw physical I/O. 

option values 

if=/i7e input file name; standard input is default 

of=/i7e output file name; standard output is default 

ibs=n input block size n bytes (default 512) 

ob8=n output block size (default 512) 

bs=n set both input and output block size, superseding ibs and obs; also, if no conver- 
sion is specified, it is particularly efficient since no in-core copy need be done 

cb8=n conversion buffer size 

skip=n skip n input blocks before starting copy 

seek=n seek n blocks from beginning of output file before copying 

count=n copy only n input blocks 
conv=a8cii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 

lease map alphabetics to lower case 

ucase map alphabetics to upper c£ise 

swab swap every pair of bytes 

noerror do not stop processing on an error 

sync pad every input block to ibs 

... , ... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may end with k, b, or w to 
specify multiplication by 1024, 512, or 2, respectively; a pair of numbers may be separated by x to 
indicate a product. 

Cbs is used only if ascii or ebcdic conversion is specified. In the former case cbs characters are 
placed into the conversion buffer, converted to ASCII, £md trailing blanks are trimmed and a new- 
line is added before sending the line to the output. In the latter case ASCII characters are read 
into the conversion buffer, converted to EBCDIC, and blanks added to make up an output block of 
size cbs. 

After completion, dd reports the number of whole and partial input and output blocks. 

EXAMPLE 

This command will read an EBCDIC tape blocked ten 80-byte EBCDIC card images per block into 
the ASCII file x : 

dd if=/dev/rmt/Om of=x ibs=800 cbs=80 conv=ascii,lcase 

Note the use of raw magtape. Dd is especially suited to I/O on the raw physical devices because 
it allows reading and writing in arbitrary block sizes. 

SEE ALSO 



Hewlett-Packard Company - 1 - Version B.l, December 1986 



DD(1) HP-UX DD(1) 



cp(l), tr(l). 

DIAGNOSTICS 

f+p blocks in(out) numbers of full and partial blocks read (written) 

WARNING 

You may experience trouble writing directly to or reading directly from a cartridge tape. For best 
results, use tcio{l) as an input or output filter. For example, use 

... I dd . . . I tcio -ovVS 256 /dev/rct/cO 
for output to a cartridge tape, and 

tcio -ivS 256 /dev/rct/cO I dd . . . I ... 
for input from a cartridge tape. 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256-character standard in the CACM 
Nov, 1968. The ibm conversion, while less widely accepted as a standard, corresponds better to 
certain IBM print train conventions. There is no universal solution. 

New-lines are inserted only on conversion to ASCII; padding is done only on conversion to 
EBCDIC. These should be separate options. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

delta - make a delta (change) to an SCCS file 

SYNOPSIS 

delta [-rSID] [-8] [-n] [-glist] [-mfmrlist]] [-y [comment]] [-p] files 

DESCRIPTION 

Delta is used to permanently introduce into the named SCCS file changes that were made to the 
file retrieved by get{l) (called the g-file, or generated file). 

Delta makes a delta to each named SCCS file. If a directory is named, delta behaves as though 
each file in the directory were specified as a named file, except that non-SCCS files (last com- 
ponent of the path name does not begin with s.) and unreadable files are silently ignored. If a 
n£ime of - is given, the standard input is read (see WARNINGS); each line of the stsmdard input is 
taken to be the name of an SCCS file to be processed. 

Delta may issue prompts on the standard output depending upon certain keyletters specified and 
flags (see admin (1)) that may be present in the SCCS file (see -m and -y keyletters below). 

Keyletter argimients apply independently to each named file. 

-Tsid Uniquely identifies which delta is to be mside to the SCCS file. The use of this 

keyletter is necessary only if two or more outstanding gets for editing (get -e) 
on the same SCCS file were done by the same person (login neime). The SID 
value specified with the -r keyletter can be either the SID specified on the get 
command line or the SID to be made as reported by the get conmiand (see 
get{l)). A diagnostic results if the specified SID is ambiguous, or, if necessary 
and omitted on the command line. 

-s Suppresses the issue, on the standard output, of the created delta's SID, as well 

as the number of lines inserted, deleted and imchanged in the SCCS file. 

-n Specifies retention of the edited g-file (normally removed at completion of delta 

processing). 

-glist Specifies a list (see get{l) for the definition of list) of deltas which are to be 

ignored when the file is accessed at the change level (SID) created by this delta. 

-m [mrlist] If the SCCS file has the v flag set (see odmm(l)) then a Modification Request 

(MR) number must be supplied as the reason for creating the new delta. 
If -m is not used and the standard input is a terminal, the prompt MRs? is 
issued on the standard output before the standsird input is read; if the standard 
input is not a terminal, no prompt is issued. The MRs? prompt always precedes 
the comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. An imescaped 
new-line character terminates the MR list. 

Note that if the v flag has a value (see admm(l)), it is taken to be the name of a 
program (or shell procedure) which will validate the correctness of the MR 
numbers. If a non-zero exit status is returned from MR niunber validation pro- 
gram, delta terminates (it is assumed that the MR nmnbers were not all valid). 

-y [comment] Arbitrary text used to describe the reason for making the delta. A null string is 
considered a veJid comment. 

If — y is not specified and the standard input is a terminal, the prompt com- 
ments? is issued on the standard output before the standard input is read; if the 
stcindard input is not a terminal, no prompt is issued. An imescaped new-line 
character terminates the comment text. 
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Causes delta to print (on the standard output) the SCCS file differences before 
and after the delta is applied in a diff{l) format. 



FILES 



All files of the form ?-file are explained in the Source Code Control System User's Guide. The 
naming convention for these files is also described there. All files below except the g-file are 
created in the same directory as the s-file. The g-file is created in the user's working directory. 

g-file Existed before the execution of delta; removed after completion of delta (imless 

-n was specified). 

p-file Existed before the execution of delta; may exist after completion of delta. 

q-file Created during the execution of delta; removed after completion of delta. 

x-file Created during the execution of delta; renamed to SCCS file after completion of 

delta. 

z-file Created during the execution of delta; removed during the execution of delta. 

d-file Created during the execution of delta; removed after completion of delta. 

/usr/bin/bdiff Progrsim to compute differences between the "gotten" file and the g-file. 
DIAGNOSTICS 

Use help{l) for explanations. 
WARNINGS 

Lines beginning with an SOH ASCII character (octal 001) cannot be placed in the SCCS file lulless 

the SOH is escaped. This character has special meaning to SCCS (see accsfile{4)) and will cause 

an error. 

A get of many SCCS files, followed by a delta of those files, should be avoided when the get gen- 
erates a large amount of data. Instead, multiple get/delta sequences should be used. 

If the standard input (-) is specified on the delta command line, the -m (if necessary) and -y 

keyletters must also be present. Omission of these keyletters causes an error to occur. 

Comments are limited to text strings of at most 512 characters. 
SEE ALSO 

admin(l), bdiff(l), cdc(l), get(l), help(l), prs(l), rmdel(l), sccsfile(4). 

SCCS User's Guide in HP-UX Concepts and Tutorials. 
DIAGNOSTICS 

Use help{l) for explanations. 
INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

deroff - remove nroff/troff, tbl, and eqn constructs 

SYNOPSIS 

deroff [-mx] [-w] [ files ] 

DESCRIPTION 

Deroff reads each of the files in sequence and removes all troff requests, macro calls, backslash 
constructs, eqn constructs (between .EQ and .EN lines, and between delimiters), and tbl{\) 
descriptions, perhaps replacing them with white space (blanks and blank lines), and writes the 
remainder of the file on the standard output. Deroff follows chains of included files (.so and .nx 
troff commands); if a file has already been included, a .so naming that file is ignored and a .nx 
naming that file terminates execution. If no input file is given, deroff reads the standard input. 

The -m option may be followed by an m, s, or 1. The -mm option causes the macros be inter- 
preted so that only nmning text is output (i.e., no text from macro lines.) The -ml option forces 
the -mm option and also causes deletion of lists associated with the mm macros. 

If the -w option is given, the output is a word list, one "word" per line, with all other characters 
deleted. Otherwise, the output follows the original, with the deletions mentioned above. In text, 
a "word" is any string that coritains at least two letters and is composed of letters, digits, amper- 
sands (&), and apostrophes ('); in a macro call, however, a "word" is a string that begins with at 
least two letters and contains a total of at least three letters. Delimiters are any characters other 
than letters, digits, apostrophes, and ampersands. Trailing apostrophes and ampersands are 
removed from "words." 

SEE ALSO 

nrofr(l), tbl(l). 

BUGS 

Deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most such 
errors result in too much rather than too little output. 
The -ml option does not handle nested lists correctly. 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

diflF, diflEh - differential file comparator 

SYNOPSIS 

diff [ -befh ] filel file2 

/uar/lib/difTh filel file2 

DESCRIPTION 

Diff tells what lines must be changed in two files to bring them into agreement. If filel {file2) is 
-, the standard input is used. If filel {file2) is a directory, then a file in that directory with the 
name file2 {filel) is used. The normal output contains lines of these forms: 

nl a nS,n4 
nl,n2 d nS 
nl,n2 c nS,n4 

These lines resemble ed commands to convert filel into file2. The numbers after the letters per- 
tfdn to file2. In fact, by exchanging a for d and reading backward one may ascertain equally how 
to convert file2 into filel. As in ed, identical pairs, where nl = n2 or nS = n4, are abbreviated 
as a single number. 

Following each of these lines come all the lines that are afi'ected in the first file flagged by <, then 
all the lines that are affected in the second file flagged by >. 

The options are: 

-b causes trailing blanks (spaces and tabs) to be ignored and other strings of blanks 

to compare equal. 

-e produces a script of a, c and d conmiands for the editor ed, which will recreate 

file2 from filel. 

-f produces a script similar to that of -e, only it is not useful with ed, and it is in 

the opposite order. 

-h does a fast, half-hearted job. It works only when changed stretches of text are 

short and well-separated, but does work on files of unlimited length. Options -e 
and -f are unavailable with -h. 

Diffli is equivalent to diflF -h. It must be invoked as shown above in the 
synopsis, unless the PATH variable in your environment includes the directory 
/usr/lib. 

In connection with -e, the following shell program may help maintain multiple versions of a file. 
Only an ancestral file ($1) and a chain of version-to-version ed scripts ($2,$3,...) made by diff 
need be on hand. A "latest version" appears on the standard output. 

(shift; cat $*; echo 'l,$p') | ed - $1 

Except in rare circiunstances, diff finds a smallest suflBcient set of file differences. 



FILES 



/tmp/d????? 
/usr/lib/diffh for -h 



SEE ALSO 

bdiff(l), cmp(l), comm(l), diff3(l), diffink(l), dircmp(l), ed(l), sccsdiff(l), sdiff(l). 

DIAGNOSTICS 

Exit status is for no differences, 1 for some differences, 2 for trouble. 

BUGS 

Ekiiting scripts produced under the -e or -f option are naive about creating lines consisting of a 
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single period (.)• 

WARNINGS 

Missing newline at end of file X indicates that the last line of file X did not have a new-line. If 
the lines are different, they will be flagged and output, although the output will seem to indicate 
they are the same. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

diffS - 3-way differential file comparison 

SYNOPSIS 

diffS [ -ex3 ] filel file2 file3 

DESCRIPTION 

DiffS compares three versions of a file, and publishes disagreeing ranges of text flagged with these 
codes: 

==== all three files differ 

=:;===1 filel is different 

====2 fiie2 is different 

====3 fileS is different 

The type of change suffered in converting a given range of a given file to some other is indicated 
in one of these ways: 

/ : fii a Text is to be appended after line niunber nl in file /, where / = 1, 2, or 

3. 

f : nl , n8 c Text is to be changed in the range line nl to line n8. If nl = n2, the 

range may be abbreviated to nl. 

The original contents of the rsmge follows immediately after a c indication. When the contents of 
two files are identical, the contents of the lower-nmnbered file is suppressed. 

Under the -e option, diffS publishes a script for the editor ed that will incorporate into filel all 
changes between file2 and fileS, i.e., the changes that normally would be flagged ==== and 
=====3. Option -X (-3) produces a script to incorporate only changes flagged ==== 
(====3). The following command will apply the resulting script to filel. 

(cat script; echo 'l,$p') | ed - filel 

FILES 

/tmp/d3* 
/usr/lib/diff3prog 

SEE ALSO 

diff(l). 

BUGS 

Text lines that consist of a single . will defeat -e. 
Files longer thein 64K bytes will not work. 

INTERNATIONAL SUPPORT 

8- 6ind 16-bit data, 8-bit filenames. 
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NAME 

diffink - mark diflFerences between files 

SYNOPSIS 

diffink namel name2 nameS 

DESCRIPTION 

Diffink compares two versions of a file and creates a third file that includes "change mark" com- 
mands for nroff{l) or troff. Namel and name2 are the old and new versions of the file. Diffmk 
generates nameS, which contains the lines of name2 plus inserted formatter "change mark" (.mc) 
requests. When nameS is formatted, changed or inserted text is shown by | at the right margin of 
each line. The position of deleted text is shown by a single *. 

If anyone is so inclined, diffmk can be used to produce listings of C (or other) programs with 
changes marked. A typical command line for such use is: 

diflfmk old.c new.c tmp; nroflf macs tmp | pr 

where the file macs contains: 

.pi 1 
.11 77 
.nf 
.eo 
.nc ^ 

The .11 request might specify a different line length, depending on the nature of the program being 
printed. The .eo and .no requests are probably needed only for C programs. 

If the characters | and * are inappropriate, a copy of diffmk can be edited to change them [diffmk 
is a shell procedure). 

SEE ALSO 

diff(l), nroff(l). 

BUGS 

Aesthetic considerations may dictate manual adjustment of some output. File differences involv- 
ing only formatting requests may produce imdesirable output, i.e., replacing .sp by .sp 2 will pro- 
duce a "change mark" on the preceding or following line of output. 

Although unlikely, certain combinations of formatting requests may cause change marks to either 
disappear or to mark too much. Manual intervention may be required as the subtleties of £ill the 
various formatting macro packages £ind preprocessors is beyond the scope of diffmk. The input to 
tbl{l) cannot tolerate .mc commands. Any .mc that would appear inside a .TS range will be 
silently deleted. The script can be changed if this action is inappropriate or diffmk can be nm on 
the output from tbl{l). 

Diffmk uses diff{l) and thus has whatever limitations on file size and performance that diff may 
impose. In particular the performance is non-linear with the size of the file, and very large files 
(well over 1000 lines) may take extremely long to process. Breaking the file into smaller pieces 
may be advisable. 

Diffmk also uses ed(l), and if the file is too large for ed, ed error messages may be imbedded in 
the file. Again, breaking the file into smaller pieces may be advisable. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 



Hewlett-Packard Company - 1 - Version B.l, October 1986 



DIRCMP(l) HP-UX DIRCMP(l) 



NAME 

dircmp - directory comparison 

SYNOPSIS 

dircmp [ -d ] [ -s ] [ -wn ] dirl dir2 

DESCRIPTION 

Dircmp examines dirl and dirS and generates various tabulated information about the contents of 
the directories. Listings of files that are unique to each directory are generated for all the options. 
If no option is entered, a list is output indicating whether the filenames common to both direc- 
tories have the same contents. 

-d Compare the contents of files with the same name in both directories and output 

a list telling what must be changed in the two files to bring them into agreement. 
The list format is described in diff{l). 

-s Suppress messages about identical files. 

-wn Change the width of the output line to n characters. The default width is 72. 

SEE ALSO 

cmp(l), diflF(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

dos2ux, ux2dos - convert ASCII file format 

SYNOPSIS 

do82ux file ... 
ux2dos file ... 

DESCRIPTION 

Dos2ux and ux2dos read each file in sequence and write it on st£indard output, converting to DOS 
format or to HP-UX format. File can be either DOS format or HP-UX format for either command. 
Thus: 

do82ux file 

prints the file on the terminal screen, while: 

ux2dos filel file2 >file3 

converts filel and file2, to DOS format, then concatenates them together, placing them in fileS. 

If no input file is given or if the sirgument — is encountered, doaSux and uxSdos read from stan- 
dard input, enabling you to combine standard input with other files. 

RETURN VALUE 

Both commands return if successful, 2 if the command failed. The only possible failure is the 
inability to open a specified file, in which case a warning is printed. 

WARNING 

Command formats resembling 

dos2ux filel file2 >filel 

overwrite the data in filel before the concatenation begins, causing a loss of the contents of filel . 
Therefore, take care when using shell special characters. 
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NAME 

doschmod - change attributes of a DOS file 

SYNOPSIS 

doschmod mode device:file ... 

DESCRIPTION 

Doschmod is the DOS counterpart of chmod{l). 

A DOS file name is recognized by the presence of cm embedded colon (:) delimiter (see dosif{4) for 
DOS file naming conventions). 

The attributes of each named file are changed according to mode, which is an octal number in the 
range 00 to 0377. mode is constructed from the logical OR of the following modes: 

040 Archive bit. This bit is set whenever the file has been written to and closed. 

020 This bit defines a sub-directory. 

010 This bit signifies that the volvune label is contained in the first 11 bytes. 

004 System file 

002 Hidden file 

001 File is marked read only 

Doschmod does not restrict the value of mode; however, some values will render the file inaccessi- 
ble to other utilities and operating systems, so special care should be taken in selecting values for 
mode. 

EXAMPLES 

The first of the following examples marks file as a directory. The second makes file read-only: 

doschmod 020 file 
doschmod 041 file 

SEE ALSO 

dosif(4), chmod(l), chmod(2). 
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NAME 

doscp - copy to or from DOS files 

SYNOPSIS 

doscp filel file2 

doscp filel [file2...] directory 

DESCRIPTION 

Doscp is the DOS counterpart of cp(l). Doscp copies a DOS or HP-UX file to a DOS or HP-UX file, 
or a list of HP-UX or DOS files to a directory. The last name on the argument list is the destina- 
tion file or directory. 

A DOS file name is recognized by the presence of an embedded colon (:) delimiter (see dos{A) for 
DOS file naming conventions). 

The DOS file naming conventions are known only by the DOS utilities. Since file name expansion 
is done by the shell, this mechanism cannot be used for expansion of DOS file names. 

The file nsime "-" (dash) is interpreted to mesm standard input or standard output depending 
upon its position in the argument list. 

Important 

Do not mount media before using doscp. 

EXAMPLES 

doscp abc /dev/hd.c:x/y/z 

Copy the HPUX file abc to the DOS file x/y/z through the HP-UX device special file 
/dev/hd. c 

doscp /dev/fd.O:/backup/log logcopy 

Copy DOS file /backup /log through the HP-UX device special file /dev/fd.O to HP-UX file 
logcopy located in the current directory. 

doscp bbtzulu - 

Copy DOS file zulu on the DOS volimie stored as HP-UX file 66 to standard output. 

SEE ALSO 

dos(4), cp(l). 

DIAGNOSTICS 

Doscp returns if the file is copied successfully. Otherwise, it prints a diagnostic and returns 
with a non-zero value. 
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NAME 

dosdf - report number of free disk clusters 

SYNOPSIS 

dosdf [ file-systems ] 

DESCRIPTION 

Dosdf is the DOS counterpart of d/(l). It prints out the cluster size in bytes and the niraiber of 
free clusters on the DOS disc. 

SEE ALSO 

dos(4), df(l). 



Hewlett-Packard Company - 1 - December 1986 



DOSLS(l) DOSLS(l) 

Series 300 Only 



NAME 

dosls, dosll - list contents of DOS directories 

SYNOPSIS 

dosls [ -adl ] [ names ] 
dosll [ -adl ] [ names ] 

DESCRIPTION 

Dosls is the DOS coimterpart of /5(1). 

A DOS file name is recognized by the presence of an embedded colon (:) delimiter (see dos{4) for 
DOS file naming conventions). 

For each directory named, dosls lists the contents of that directory; for each file named, dosls 
repeats its name £ind any other information requested. 

If you are super-user, doslss defaults to listing all files except . (current directory) and .. (parent 
directory). If invoked by the name dosll, the -1 option is implied. 

There are several options: 

-a List all entries. In the absence of this option, hidden files, system files and entries whose 

names begin with a dot ( . ) are not listed. 

-A Same as -a, except that the current directory and the parent directory are not listed. For 
super-user, this flag defaults to ON, and is disabled by -A. 

— d If argmnent is a directory, list only its name. Often used with —1 to get the status of a 

directory. 

-1 List in long format, giving file attribute, size in bytes, and the date and time of last 

modification for each file. Long listing is disabled if dosll is invoked with the -1 option. 

EXAMPLES 

The examples that follow assume that an DOS directory structure exists on the device accessed 
through HP-UX device special file /dev/fd.O. 

This example lists all of the files in the root directory of the DOS directory structure: 

dosls -a /dev/fd.O: 

This second example produces a long-format listing of all the information about the DOS directory 
/users/root but does not list the files in the directory: 

dosls -Id /dev/fd.Oi/users/root 

IMPORTANT REMINDER 

To obtain a listing of DOS files on the device accessed HP-UX device special file /dev/fd, be sure to 
include the colon as in 

dosls /dev/fd:. 

If the colon is omitted as in 

dosls /dev/fd, 

a listing of the HP-UX file /dev/fd is produced, not the contents of the DOS directory accessed 
through /dev/fd. 

SEE ALSO 

dos(4), ls(l). 
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NAME 

dosmkdir - make a DOS directory 

SYNOPSIS 

dosmkdir device:dimame ... 

DESCRIPTION 

Dosmkdir is the DOS counterpart of mkdir{l). 

A DOS file name is recognized by the presence of an embedded colon (:) delimiter (see dos{4) for 
DOS file naming conventions). 

Dosmkdir creates specified directories. The standard entries, . for the directory itself and .. for 
its parent, are made automatically. 

EXAMPLES 

To create an empty subdirectory named sysmods imder the directory /usr/lib on HP-UX device 
/dev/dos2, use: 

dosmkdir /dev/dos2:/usr/lib/sysmods 

SEE ALSO 

dos(4), mkdir(l). 

DIAGNOSTICS 

Dosmkdir returns if all directories were successfully created. Otherwise, it prints a diagnostic 
and returns non-zero. 
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NAME 

dosrm, dosrmdir - remove DOS files or directories 

SYNOPSIS 

dosrm [ -fri ] device:file ... 

dosrmdir device :dir ... 

DESCRIPTION 

Dosrm and dosrmdir are DOS counterparts of rm(l) and rmdir(l), respectively. 

A DOS file name is recognized by the presence of an embedded colon (:) delimiter (see dos{4) for 
DOS file naming conventions). 

Dosrm removes the entries for one or more files from a directory. 

If a designated file is a directory, an error comment is printed (unless the optional argmnent -r 
has been used as described below). 

The options are: 

-f Unconditionally removes the specified file, even if the file is marked read-only. 

-r Causes dosrm to recursively delete the entire contents of a directory, followed by 

the directory itself. Dosrm can recursively delete up to 17 levels of directories. 

-i Causes dosrm to ask whether or not to delete each file. If -r is also specified, 

dosrm asks whether to examine each directory encountered. 

Dosrmdir Removes entries for the named directories, provided they are empty. 

EXAMPLES 

The following examples assume that an DOS directory structure exists on the HP-UX device file 
/dev/dosdisc . 

This example recursively combs through the DOS directory /tmp and asks if each DOS file should 
be removed (forced, with no file mode checks): 

dosrm -irf /dev/dosdisc:/tmp 

This example removes the DOS directory /users/ doug: 
dosrmdir sc:/users/doug 

SEE ALSO 

dos(4), rm(l), rmdir(l). 
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NANfE 

du - summarize disk usage 

SYNOPSIS 

du [ -sar ] [ names ] 

DESCRIPTION 

Du gives the niunber of 512-byte blocks contained in all files and (recursively) directories within 
each directory and file specified by the names argiunent. The block coimt includes the indirect 
blocks of the file. If names is missing, . is used. 

The optional Eirgument -s causes only the grand total (for each of the specified names) to be 
given. The optional argument -a causes £in entry to be generated for each file. Absence of either 
causes an entry to be generated for each directory only. 

Du is normally silent about directories that cannot be read, files that cannot be opened, etc. The 
-r option will cause du to generate messages in such instances. 

A file with two or more links is only coimted once. 

BUGS 

If the -a option is not used, non-directories given as argiunents are not listed. 

If there are too many distinct linked files, du will coimt the excess files more than once. 

Files with holes in them will get an incorrect block count. 

If multiple links are involved, du can give different results, depending on the order of names. 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

echo - echo (print) arguments 

SYNOPSIS 

echo [ arg ] ... 

DESCRIPTION 

Echo writes its arguments separated by blanks and terminated by a new-line on the standard out- 
put. It also imderstands C-like escape conventions; beware of conflicts with the shell's use of \: 

\b backspace 

\c print line without appending a new-line 

\f form-feed 

\n new-line 

\r carriage return 

\t . tab 
\v vertical tab 

\\ backslash 

\n the 8-bit character whose ASCII code is the 1-, 2-, 3- or 4-digit octal number n, 

whose first character must be a zero. 

Echo is useful for producing diagnostics in command files and for sending known data into a pipe. 

SEE ALSO 

sh(l). 

NOTES 

Berkeley echo differs from this implementation. The former does not implement the backslash 
escapes. However, the semantics of the \c escape can be obtained by using the -n option. The 
echo command implemented as a built-in function of csh{l) follows the Berkeley semantics. 

BUGS 

No characters are printed after the first \c. This is not normally a problem. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

ed, red - text editor 

SYNOPSIS 

ed [ - ] [ -p string ] [ -x ] [ file ] 

•"^d [ ~ ] [ ~P string ] [ -X ] [ file ] 

REMARKS 

The decryption facilities provided by this software are under control by the United States Govern- 
ment and cannot be exported without special licenses. The capabilities are only available by spe- 
cial arrangement through HP. 

DESCRIPTION 

Ed is the standard (line-oriented) text editor. If the file argument is given, ed simulates an e 
command (see below) on the named file; that is to say, the file is read into erf's buffer so that it 
can be edited. The optional - suppresses the printing of character coimts by e, r, and w com- 
mands, of diagnostics from e and q commands, and of the ! prompt after a \ shell command, -p 
option allows the user to specify a prompt string. If -x is present, an x command is simulated 
first to handle an encrypted file. Ed operates on a copy of the file it is editing; changes made to 
the copy have no effect on the file until a w (write) commtind is given. The copy of the text being 
edited resides in a temporary file called the buffer. There is only one buffer. 

Red is a restricted version of erf. It will only allow editing of files in the cxurrent directory. It 
prohibits executing shell commands via I shell command. Attempts to bypass these restrictions 
result in an error message (restricted shelf). 

Both erf and red support the fspec{4) formatting capability. After including a format specification 
as the first line of file and invoking erf with your terminal in stty -tabs or stty tabS mode (see 
stty{l), the specified tab stops will automatically be used when scanning file. For example, if the 
first line of a file contained: 

<:t5,10,15 s72:> 
tab stops would be set at columns 5, 10, and 15, and a maximum line length of 72 would be 
imposed. NOTE: while inputting text, tab characters when typed are expanded to every eighth 
column as is the default. 

Commands to erf have a simple and regular structure: zero, one, or two addresses followed by a 
single-character command, possibly followed by parameters to that command. These addresses 
specify one or more lines in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands allow the input of text. 
This text is placed in the appropriate place in the buffer. While erf is accepting text, it is said to 
be in input mode. In this mode, no commands are recognized; all input is merely collected. Input 
mode is left by typing a period ( . ) alone at the beginning of a line. 

Ed supports a limited form of regular expression notation; regular expressions are used in 
addresses to specify lines and in some commands (e.g., s) to specify portions of a line that are to 
be substituted. A regular expression (RE) specifies a set of character strings. A member of this 
set of strings is said to be matched by the RE. The REs allowed by erf are constructed as follows: 

The following one-character REs match a single character: 

1.1 An ordinary character {not one of those discussed in 1.2 below) is a one-character RE that 
matches itself. 

1.2 A backslash (\) followed by any special character mentioned below is a one-character RE 
that matches the special character itself. The special characters are: 

a. ., *, [, and \ (period, asterisk, left square bracket, and backslash, respectively), which 
are always special, except when they appear within square brackets ([]; see 1.4 below). 
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b. ' (caret or circumflex), which is special at the beginning of an entire RE (see 3.1 and 
3.2 below), or when it immediately follows the left of a pair of square brackets ( [ ] ) (see 
1.4 below). 

c. $ (currency symbol), which is special at the end of an entire RE (see 3.2 below). 

d. The character used to boimd (i.e., delimit) £in entire RE, which is special for that RE 
(for example, see how slash (/) is used in the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character except new-line. 

1.4 A non-empty string of characters enclosed m square brackets ( [ ] ) is a one-character RE that 
matches any one character in that string. If, however, the first character of the string is a 
circmnflex ("), the one-character RE matches any character except new-line and the remain- 
ing characters in the string. The " has this special meaning only if it occurs first in the 
string. The minus (-) may be used to indicate a range of consecutive ASCII characters; for 
example, [0-9] is equivalent to [0123456789] . The - loses this special meaning if it occiu^ 
first (after an initial ", if any) or last in the string. The right square bracket (]) does not 
terminate such a string when it is the first character within it (after an initial ', if any); 
e.g., []a-f] matches either a right square brsicket (]) or one of the letters a through f 
inclusive. The four characters listed in 1.2.a above stand for themselves within such a string 
of characters. 

The following rules may be used to construct REs from one-character REs: 

2.1 A one-character RE is a RE that matches whatever the one-character RE matches. 

2.2 A one-character RE followed by aji asterisk (*) is a RE that matches zero or more 
occurrences of the one-character RE. If there is any choice, the longest leftmost string that 
permits a match is chosen. 

2.3 A one-character RE followed by \{m\}, \{'ti,\}, or \{m,n\} is a RE that matches a range 
of occurrences of the one-character RE. The values of m and n must be non-negative 
integers less than 256; \{m\} matches exactly m occurrences; \{wi,\} matches at least m 
occurrences; \{"i,n\} matches any number of occurrences between m and n inclusive. 
Whenever a choice exists, the RE matches as many occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of the strings matched by 
each component of the RE. 

2.5 A RE enclosed between the character sequences \( and \) is a RE that matches whatever 
the unadorned RE matches. 

2.6 The expression \n matches the same string of characters as was matched by an expression 
enclosed between \( and \) earlier in the same RE. Here n is a digit; the sub-expression 
specified is that beginning with the n-th occurrence of \( counting from the left. For exam- 
ple, the expression '\(.*\)\1$ matches a line consisting of two repeated appearances of the 

same string. 

Finally, an entire RE may be constrained to match only an initial segment or final segment of a 
line (or both). 

3.1 A circiunflex (') at the beginning of an entire RE constrains that RE to match an initial seg- 
ment of a line. 

3.2 A cmrency symbol ($) at the end of an entire RE constrains that RE to match a final seg- 
ment of a line. 

The construction * entire RE$ constrains the entire RE to match the entire line. 

The null RE (e.g., //) is equivalent to the last RE encoimtered. See also the last paragraph before 
FILES below. 
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To understand addressing in ed it is necessary to know that at any time there is a current line. 
Generally speaking, the ciorrent line is the last line affected by a command; the exact effect on the 
ciurent line is discussed imder the description of each command. Addresses are constructed as 
follows: 

1. The character . addresses the cmrent line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. ix addresses the line marked with the mark name character a:, which must be a lower-case 
letter. Lines are marked with the k command described below. 

5. A RE enclosed by slashes (/) addresses the first line foimd by searching forward from the 
line following the current line toward the end of the buffer and stopping at the first line 
containing a string matching the RE. If necessary, the search wraps aroimd to the begin- 
ning of the buffer and continues up to and including the ciurent line, so that the entire 
buffer is searched. See also the last paragraph before FILES below. 

6. A RE enclosed in question marks (?) addresses the first line foimd by searching backward 
from the line preceding the current line toward the beginning of the buffer and stopping 
at the first line containing a string matching the RE. If necessary, the search wraps 
around to the end of the buffer and continues up to and including the current line. See 
also the last paragraph before FILES below. 

7. An address followed by a plus sign ( -|- ) or a minus sign (-) followed by a decimal nmnber 
specifies that address plus (respectively minus) the indicated number of lines. The plus 
sign may be omitted. 

8. If an address begins with + or -, the addition or subtraction is taken with respect to the 
cm-rent line; e.g, -5 is understood to mean .-5. 

9. If an address ends with -f- or -, then 1 is added to or subtracted from the address, respec- 
tively. As a consequence of this rule and of rule 8 immediately above, the address - refers 
to the line preceding the ciurent line. (To maintain compatibility with earlier versions of 
the editor, the character * in addresses is entirely equivalent to -.) Moreover, trailing -f 
and - characters have a cumulative effect, so — refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address pair I,$, while a semicolon (;) 
stands for the pair . ,$. 

Commands may require zero, one, or two addresses. Commands that require no addresses regard 
the presence of an address as an error. Commands that accept one or two addresses assume 
default addresses when an insufficient number of addresses is given; if more addresses are given 
than such a command requires, the last one(s) are used. 

Typically, addresses are separated from each other by a comma (,). They may also be separated 
by a semicolon (;). In the latter case, the current line (.) is set to the first address, and only then 
is the second address calculated. This feature can be used to determine the starting line for for- 
ward and backward searches (see rules 5. and 6. above). The second address of any two-address 
sequence must correspond to a line that follows, in the buffer, the line corresponding to the first 
address. 

In the following list of ed commands, the default addresses are shown in parentheses. The 
parentheses are not part of the address; they show that the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. However, any command 
(except e, /, r, or «;) may be suffixed by 1, n, or p in which case the current line is either listed, 
numbered or printed, respectively, as discussed below under the /, n, and p commands. 
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(.)a 
<text> 



(.)c 
<text> 



The append command reads the given text smd appends it Eifter the addressed 
line; . is left at the last inserted line, or, if there were none, at the addressed line. 
Address is legal for this conunand: it causes the "appended" text to be placed 
at the beginning of the buffer. The maximum mmiber of characters that may be 
entered from a terminal is 256 per line (including the new-line character). 



(.,.)d 



e file 



E file 



ffile 



The change command deletes the addressed lines, then accepts input text that 
replaces these lines; . is left at the last line input, or, if there were none, at the 
first line that was not deleted. 

The delete command deletes the addressed lines from the buffer. The line after 
the last line deleted becomes the current line; if the lines deleted were originally 
at the end of the buffer, the new last line becomes the ciurent line. 

The edit command causes the entire contents of the buffer to be deleted, and 
then the named file to be read in; . is set to the last line of the buffer. If no file 
name is given, the currently-remembered file name, if any, is used (see the / com- 
mand). The nmnber of characters read is typed; file is remembered for possible 
use as a default file name in subsequent e, r, and w commands. If file is 
replaced by !, the rest of the line is taken to be a shell (a/i(l)) command whose 
output is to be read. Such a shell command is not remembered as the current 
file name. See also DIAGNOSTICS below. 

The Edit command is like e, except that the editor does not check to see if any 
changes have been made to the buffer since the last w command. 



If file is given, the /ile-name command changes the currently-remembered file 
name to file; otherwise, it prints the currently-remembered file name. 

( 1 , $ )%/ RE / command list 

In the (global command, the first step is to mark every line that matches the 
given RE. Then, for every such line, the given command Hat is executed with . 
initially set to that line. A single command or the first of a list of commands 
appears on the same line as the global commsind. All lines of a multi-line list 
except the last line must be ended with a \; o, i, and c commands and associ- 
ated input are permitted. The . terminating input mode may be omitted if it 
would be the last line of the command list. An empty command list is 
equivalent to the p command. The g, G, v, and V commands are not permitted 
in the command list. See also BUGS and the last paragraph before FILES below. 



{1,$)G/ RE/ 



In the interactive Global command, the first step is to mark every line that 
matches the given RE. Then, for every such line, that line is printed, . is 
changed to that line, and any one command (other than one of the a, c, », </, G, 
V, and V commands) may be input and is executed. After the execution of that 
command, the next marked line is printed, and so on; a new-line acts as a null 
command; an Sc causes the re-execution of the most recent command executed 
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within the current invocation of G. Note that the coimnanus input as part of 
the execution of the G command may address and affect any lines in the buffer. 
The G command can be terminated by an interrupt signal (ASCII DEL or 
BREAK). 

The /ielp command gives a short error message that explains the reason for the 
most recent ? diagnostic. 



H 



<text> 



(.,.+l)J 
(.)kx 



The //elp command causes erf to enter a mode in which error messages are 
printed for all subsequent ? diagnostics. It will also explain the previous ? if 
there was one. The H command alternately turns this mode on and off; it is ini- 
tially off. 



The insert command inserts the given text before the addressed line; . is left at 
the last inserted line, or, if there were none, at the addressed line. This com- 
mand differs from the a command only in the placement of the input text. 
Address is not legal for this command. The maximimi munber of characters 
that may be entered from a terminal is 256 per line (including the new-line char- 
acter). 

The join command joins contiguous lines by removing the appropriate new-line 
characters. If exactly one address is given, this command does nothing. 

The marA coiomand marks the addressed line with name i, which must be a 
lower-case letter. The address ix then addresses this line; . is unchanged. 

The /ist command prints the addressed lines in an imambiguous way: a few 
non-printing characters (e.g., tab, backspace) are represented by (hopefully) 
mnemonic overstrikes. All other non-printing characters are printed in octal, 
and long lines are folded. An / command may be appended to any other com- 
mand other than c, /, r, or w. 

The move command repositions the addressed line(s) sifter the line addressed by 
a. Address is legal for a and causes the addressed line(s) to be moved to the 
beginning of the file. It is an error if address a falls within the range of moved 
lines; . is left at the last line moved. 

The number command prints the addressed lines, preceding each line by its line 
nmnber and a tab character; . is left at the last line printed. The n cormnand 
may be appended to any other conmiand other than e, /, r, or w. 

The print command prints the addressed lines; . is left at the last line printed. 
The p command may be appended to any other cormnand other than e, /, r, or 
w. For example, dp deletes the current line and prints the new current line. 

The editor will prompt with a * for all subsequent commands. The P commsmd 
alternately turns this mode on and off; it is initially off. 
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Q 

($)r/t7e 



The quit command causes ed to exit. No automatic write of a file is done (but 
see DIAGNOSTICS below). 

The editor exits without checking if changes have been made in the buffer since 
the last w command. 

The read command reads in the given file after the addressed line. If no file 
name is given, the currently-remembered file name, if any, is used (see e and / 
commands). The currently-remembered file name is not changed unless file is 
the very first file name mentioned since ed was invoked. Address is legal for r 
and causes the file to be read at the beginning of the buffer. If the read is suc- 
cessful, the nmnber of characters read is typed; . is set to the last line read in. If 
file is replaced by !, the rest of the line is taken to be a shell (3/1(1)) command 
whose output is to be read. For example, "$r !ls" appends current directory to 
the end of the file being edited. Such a shell command is not remembered as the 
current file name. 



( . , . )b/ RE /replacement/ 
or 
( . , . )a/RE/replacement/g 

or 
( . , , )s/ RE/ replacement /n 

n = 1-512 



(.,.)ta 



The substitute command searches each addressed line for an occurrence of the 
specified RE. In each line in which a match is foimd, all (non-overlapped) 
matched strings are replaced by the replacement if the global replacement indica- 
tor g appears after the conmiand. If the global indicator does not appear, only 
the first occurrence of the matched string is replaced. If a number n appears 
after the command, only the n th occurrence of the matched string on each 
addressed line is replaced. It is an error for the substitution to fail on all 
addressed lines. Any character other than space or new-line may be used instead 
of / to delimit the RE and the replacement; . is left at the last line on which a 
substitution occurred. See also the last paragraph before FILES below. 

An ampersand (&) appearing in the replacement is replaced by the string 
matching the RE on the current line. The special meaning of & in this context 
may be suppressed by preceding it by \. As a more general feature, the charac- 
ters \n, where n is a digit, are replaced by the text matched by the n-th regular 
subexpression of the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is determined by counting 
occiurences of \( starting from the left. When the character % is the only char- 
Eicter in the replacement, the replacement used in the most recent substitute 
command is used as the replacement in the current substitute command. The % 
loses its specisil meaning when it is in a replacement string of more than one 
character or is preceded by a \. 

A line may be split by substituting a new-line character into it. The new-line in 
the replacement must be escaped by preceding it by \. Such substitution carmot 
be done as part of a j or v command list. 

This command acts just like the m command, except that a copy of the 
addressed lines is placed after address a (which may be 0); . is left at the last 
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line of the copy. 

u 

The undo command nullifies the effect of the most recent command that 
modified anything in the buffer, namely the most recent o, c, d, g, i, j, m, r, s, 
t, V, G, or V command. 

( 1 , $ )y / RE / command list 

This command is the same as the global command g except that the command 
list is executed with . initially set to every line that does not match the RE. 



{1,$)V/RE/ 
(l,$)w/t7e 



($)= 

I shell command 



This command is the same as the interactive global command G except that the 
lines that are marked during the first step are those that do not match the RE. 

The write command writes the addressed lines into the named file. If the file 
does not exist, it is created with mode 666 (readable and writable by everyone), 
imless your umask setting (see aA(l)) dictates otherwise. The currently- 
remembered file name is not changed unless file is the very first file name men- 
tioned since ed was invoked. If no file name is given, the currently-remembered 
file name, if any, is used (see e and / commands); . is unchanged. If the com- 
mand is successful, the number of characters written is typed. If file is replaced 
by !, the rest of the line is taken to be a shell (5/1(1)) command whose standard 
input is the addressed lines. Such a shell command is not remembered as the 
current file name. 

A key string is demanded from the standard input. Subsequent e, r, and w com- 
mands will encrypt and decrypt the text with this key by the algorithm of 
crypt{l). An explicitly empty key turns off encryption. 

The line number of the addressed line is typed; . is unchanged by this command. 



The remainder of the line after the ! is sent to the HP-UX shell (s/i(l)) to be 
interpreted as a command. Within the text of that command, the xmescaped 
character % is replaced with the remembered file name; if a ! appears as the first 
character of the shell command, it is replaced with the text of the previous shell 
command. Thus, !! will repeat the last shell command. If any expansion is per- 
formed, the expanded line is echoed; . is unchanged. 

(.-|-l)<new-line> 

An address alone on a line causes the addressed line to be printed. A new-line 
alone is equivalent to .-|-lp; it is useful for stepping forward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and returns to its command 
level. 

Some size limitations: 512 characters per line, 256 characters per global command list, 64 charac- 
ters per file name, and 128K characters in the buffer. The limit on the munber of lines depends 
on the amount of user memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters and all characters after the last new-line. 
Files (e.g., a.out) that contain characters not in the ASCII set (bit 8 on) carmot be edited by ed. 

If the closing delimiter of a RE or of a replacement string (e.g., /) would be the last character 
before a new-line, that delimiter may be omitted, in which case the addressed line is printed. The 
following pairs of commands are equivalent: 
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s/sl/s2 s/sl/s2/p g/sl g/sl/p ?sl ?sl? 

HARDWARE DEPENDENCIES 

Series 500 

Certain older interface cards do not support tty -tabs or stty tabS. This precludes the 
use of the /spec (4) formatting capability. 



FILES 



/tmp/e# temporary; # is the process number, 
ed.hup work is saved here if the terminal is himg up. 



SEE ALSO 

awk(l), crypt(l), edit(l), ex(l), grep(l), sed(l), sh(l), stty(l), vi(l), fspec(4), regexp(5). 

The ed Editor, in HP-UX: Selected Articles. 

DIAGNOSTICS 

? for command errors. ?file for an inaccessible file. 

(use the ftelp and Help commands for detailed explanations). 

If changes have been made in the buffer since the last w command that wrote the entire buffer, ed 
warns the user if an attempt is made to destroy ed's buffer via the e or g commands. It prints ? 
and allows one to continue editing. A second e or q command at this point will take effect. The 
- command-line option inhibits this feature. 

CAVEATS AND BUGS 

A ! command cannot be subject to a j or a i; command. 

The ! command and the ! escape from the e, r, and w commands cannot be used if the the editor 

is invoked from a restricted shell (see sh{l)). 

The sequence \n in a RE does not match a new-line character. 

The / command mishandles DEL. 

Files encrypted directly with the crypt{l) command with the null key cannot be edited. 

If the editor input is coming from a command file (i.e., ed file < ed-cmd-file), the editor will exit 

at the first failure of a command that is in the command file. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

edit - text editor (variant of ex for casual users) 

SYNOPSIS 

edit [ -r ] name ... 

DESCRIPTION 

Edit is a variant of the text editor ex recommended for new or casual users who wish to use a 
command-oriented editor. The following brief introduction should help you get started with edit. 
If you are using a CRT terminal you may want to lesim about the display editor vi. 

BRIEF INTRODUCTION 

To edit the contents of an existing file you begin with the command "edit name" to the shell. 
Edit makes a copy of the file which you can then edit, and tells you how many lines and charac- 
ters are in the file. To create a new file, just make up a name for the file and try to rvm edit on it; 
you will cause an error diagnostic, but do not worry. 

Edit prompts for commands with the charjicter ':', which you should see after starting the editor. 
If you are editing an existing file, then you will have some lines in edit 's buffer (its name for the 
copy of the file you are editing). Most conamands to edit use its "current line" if you do not tell 
them which line to use. Thus if you say print (which can be abbreviated p) £ind hit carriage 
return (as you should after all edit commands) this current line will be printed. If you delete (d) 
the current line, edit will print the new current line. When you start editing, edit makes the last 
line of the file the current line. If you delete this last line, then the new last line becomes the 
current one. In general, after a delete, the next line in the file becomes the current line. (Delet- 
ing the last line is a special case.) 

If you start with £in empty file or wish to add some new lines, then the append (a) command can 
be used. After you give this command (typing a carriage return after the word append) edit will 
read lines from your terminal xmtil you give a line consisting of just a ".", placing these lines after 
the current line. The last line you type then becomes the current line. The command insert (i) 
is like append but places the lines you give before, rather than after, the ciu-rent line. 

Edit numbers the lines in the buffer, with the first line having nmnber 1. If you give the com- 
mand "1" then edit will type this first line. If you then give the command delete edit will delete 
the first line, line 2 will become line 1, and edit will print the current line (the new line 1) so you 
can see where you are. In general, the current line will always be the last line affected by a com- 
mand. 

You can make a change to some text within the current line by using the substitute (s) com- 
mand. You say "s/old/new/" where old is replaced by the old characters you want to get rid of 
and new is the new characters you want to replace it with. 

The command file (f) will tell you how many lines there are in the buffer you are editing and will 
say "[Modified]" if you have changed it. After modifying a file you can put the buffer text back 
to replace the file by giving a write (w) command. You can then leave the editor by issuing a 
quit (q) command. If you nm edit on a file, but do not change it, it is not necessary (but does no 
harm) to write the file back. If you try to quit from edit after modifying the buffer without writ- 
ing it out, you will be warned that there has been "No write since last change" £md edit will 
await another command. If you wish not to write the buffer out then you can issue another quit 
command. The buffer is then irretrievably discarded, and you return to the shell. 

By using the delete and append commands, and giving line numbers to see lines in the file you 
can make any changes you desire. You should learn at least a few more things, however, if you 
are to use edit more than a few times. 

The change (c) command will change the current line to a sequence of lines you supply (as in 
append you give lines up to a line consisting of only a "."). You can tell change to change more 
than one line by giving the line numbers of the lines you want to change, i.e., "3,5change". You 
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can print lines this way too. Thus "l,23p" prints the first 23 Unes of the file. 

The undo (u) command will reverse the effect of the last command you gave which changed the 
buffer. Thus if you give a substitute command which does not do what you want, you can say 
undo and the old contents of the line will be restored. You can also undo an undo command so 
that you can continue to change yoiu- mind. Edit will give you a warning message when com- 
mands you do affect more than one line of the buffer. If the amoimt of change seems tmreason- 
able, you should consider doing an undo and looking to see what happened. If you decide that the 
change is ok, then you can undo again to get it back. Note that commands such as write and quit 
cannot be undone. 

To look at the next line in the buffer you can just hit carriage return. To look at a nmnber of 
lines hit 'D (control key and, while it is held down D key, then let up both) rather than carriage 
return. This will show you a half screen of lines on a CRT or 12 lines on a hardcopy terminal. 
You can look at the text aroimd where you are by giving the command "z.". The ciurent line 
will then be the last line printed; you can get back to the line where you were before the "z." 
command by saying """. The z conmiand can also be given other following characters "z-" 
prints a screen of text (or 24 lines) ending where you are; "z-|-" prints the next screenful. If you 
want less than a screenful of lines, tyi)e in "z.l2" to get 12 lines total. This method of giving 
coimts works in general; thus you can delete 5 lines starting with the cmrent line with the com- 
mand "delete 5". 

To find things in the file, you can use line munbers if you happen to know them; since the line 
munbers change when you insert and delete lines this is somewhat unreliable. You can search 
backwards and forwards in the file for strings by giving commands of the form /text/ to search 
forward for text or ?text? to search backward for text. If a search reaches the end of the file 
without finding the text it wraps, end siround, and continues to search back to the line where you 
are. A useful feature here is a search of the form /"text/ which searches for text at the beginning 
of a line. Similarly /text$/ searches for text at the end of a line. You can leave off the trailing / 
or ? in these commands. 

The current line has a symbolic name "."; this is most useful in a range of lines as in "., Sprint" 
which prints the rest of the lines in the file. To get to the last line in the file you can refer to it 
by its symbolic name "$". Thus the command "$ delete" or "$d" deletes the last line in the file, 
no matter which line was the current line before. Arithmetic with line references is also possible. 
Thus the line "$-5" is the fifth before the last, and ".-1-20" is 20 lines after the present. 

You can find out which line you are at by doing ".=". This is useful if you wish to move or copy 
a section of text within a file or between files. Find out the first and last line nimabers you wish 
to copy or move (say 10 to 20). For a move you can then say "10,20delete a" which deletes these 
lines from the file and places them in a buffer neimed o. Edit has 26 such buffers named a through 
z. You can later get these lines back by doing "put a" to put the contents of buffer a after the 
current line. If you want to move or copy these lines between files you can give an edit (e) com- 
mand after copying the lines, following it with the name of the other file you wish to edit, i.e., 
"edit chapter2". By changing delete to yank above you can get a pattern for copying luies. If the 
text you wish to move or copy is all within one file then you can just say "10,20move $" for 
example. It is not necessary to use named buffers in this case (but you can if you wish). 

SEE ALSO 

ex(l), vi(l). 

INTERNATIONAL SUPPORT 

8-bit smd 16-bit data, 8-bit filenames, messages. 
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NAME 

enable, disable - enable/disable LP printers 

SYNOPSIS 

enable printers 

disable [-c] [-r[ reason]] printers 

DESCRIPTION 

Enable activates the named printers, enabling them to print requests taken by /p(l). Use 
lpstat{l) to find the status of printers. 

Disable deactivates the named printers, disabling them from printing requests taken by /p(l). By 
default, any requests that are currently prmting on the designated printers will be reprinted in 
their entirety either on the same printer or on another member of the same class. Use lpstat{l) to 
find the status of printers. Options useful with disable are: 

-c Cancel any requests that are currently printing on any of the designated 

printers. 

-r[reason] Associates a reason with the deactivation of the printers. This reason applies to 

all printers mentioned up to the next -r option. If the -r option is not present 
or the -r option is given without a reason, then a default reason will be used. 
Reason is reported by lpstat{l). 

FILES 

/usr/spool/lp/* 

SEE ALSO 

lp(l), Ipstat(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, messages 
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NAME 

env - set environment for command execution 

SYNOPSIS 

env [-] [ name=value ] ... [ conmasmd args ] 

DESCRIPTION 

Env obtains the current environment, modifies it according to its argmnents, then executes the 
command with the modified enviromnent. Arguments of the form name=value are merged into 
the inherited environment before the command is executed. The - flag causes the inherited 
environment to be ignored completely, so that the command is executed with exactly the environ- 
ment specified by the arguments. 
If no commeind is specified, the resulting environment is printed, one name-value pair per line. 

SEE ALSO 

sh(l), exec(2), profile(4), environ(5). 

INTERNATIONAL SUPPORT 
8-bit data £ind filenames. 
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NAME 

err - report error information on last failure 

SYNOPSIS 
err 

Remarks: 

Err is implemented on the Series 500 only. 

DESCRIPTION 

Err produces error information on the standard output for the last command which failed. The 
errno, errinfo, and octal trapno values are listed. 

Error information on the last child process which reported a failure is inherited across a fork and 
cleared by exec. The error values are also passed back fi-om child to parent to grandparent as 
long as no errors were detected in the intermediate parent. Intervening commands which are exe- 
cuted successfully have no effect on the saved error information. If a command thinks it success- 
fully completed, and returns an exit status of zero, no error information will be returned. 

In general, the values reported are for a kernel intrmsic which failed, although values of errno or 
errinfo which are set by libraries or conunands will also be reported. 

SEE ALSO 

ermo(2), errinfo(2), trapno(2). 

WARNING 

This command may change in future releases of HP-UX. Err is intended for diagnostic purposes 
only. 

BUGS 

Information on a real error can be masked by "normal" errors caused by library routines or com- 
mands. For example, the library routine isatty will generate the error ENOTTY during normal 
operation. 
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NAME 

ex - text editor 

SYNOPSIS 

^'^ [ ~ ] [ ~v 1 [ ~* ^"S ] [ "•■ 1 ( ~^ ] [ +command ] [ -1 ] [ -x ] name ... 
REMARKS 

The decryption facilities provided by this software are imder the control of the United States 
Government and cannot be exported without special licenses. These capabilities are only available 
by special arrangement through HP. 

DESCRIPTION 

Ex is the root of a family of editors including: ex, edit and vi. Ex is a superset of ed, with the 
most notable extension being a display editing faciUty. Display based editing is the focus of vi. 

If you have a CRT terminal, you may wish to use a display based editor; in this case see m(1), 
which is a command which focuses on the display editing portion of ex. 

DOCUMENTATION 

The Ex Reference Manual is a comprehensive and complete manual for the command mode 
features of ex, but you cannot learn to use the editor by reading it. For an introduction to more 
advanced forms of editing using the command mode of ex, see the editing docimients written by 
Brian Kemighan for the editor ed; the material in the introductory and advanced documents 
works also with ex. 

An Introduction to Display Editing with Vi introduces the display editor vi and provides refer- 
ence material on vi. The Vi Quick Reference card simamarizes the commands of w in a useful, 
functional way, and is useful with the Introduction. The vi{l) manual page can also be used as 
reference. 

FOR ED USERS 

If you have used ed you will find that ex has a number of new features useful on CRT terminals. 
Intelligent terminals and high speed terminals are very pleasant to use with vi. Generally, the 
editor uses far more of the capabilities of terminals than ed does, and uses the terminal capability 
data base terminfo{4) and the type of the terminal you are using from the variable TERM in the 
environment to determine how to drive your terminal efiiciently. The editor makes use of features 
such as insert and delete character and line in its visual conunand (which can be abbreviated vi) 
and which is the central mode of editing when using 111(1). 

Ex contains a number of new features for easily viewing the text of the file. The z conunand gives 
easy access to windows of text. Hitting 'D causes the editor to scroll a half-window of text and is 
more useful for quickly stepping through a file than just hitting retvun. Of course, the screen- 
oriented visual mode gives constant access to editing context. 

Ex gives you more help when you make mistakes. The undo (u) command allows you to reverse 
any single change which goes astray. Ex gives you a lot of feedback, normally printing changed 
lines, and indicates when more than a few lines are affected by a command so that it is Ccisy to 
detect when a command has afi'ected more lines than it should have. 

The editor also normally prevents overwriting existing files tmless you edited them so that you do 
not accidentally clobber with a write a file other than the one you £ire editing. If the system (or 
editor) crashes, or you accidentally hang up the phone, you can use the editor recover command 
to retrieve yoiu- work. This will get you back to within a few lines of where you left off. 

Ex has several features for defiling with more than one file at a time. You can give it a list of files 
on the command line and use the next (n) command to deal with each in turn. The next com- 
mand can also be given a list of file names, or a pattern as used by the shell to specify a new set 
of files to be dealt with. In general, filenames in the editor may be formed with full shell metasyn- 
tax. The metacharacter '%' is also available in forming filenames and is replaced by the name of 
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For moving text between files and within a file the editor has a group of buffers, named o through 
z. You can place text in these named buffers and carry it over when you edit another file. 

There is a command & in ez which repeats the last substitute command. In addition there is a 
confirmed substitute command. You give a range of substitutions to be done and the editor 
interactively asks whether each substitution is desired. 

It is possible to ignore case of letters in sesirches and substitutions. Ex also allows regular expres- 
sions which match words to be constructed. This is convenient, for example, in searching for the 
word "edit" if your dociunent also contains the word "editor." 

Ex has a set of options which you can set to tailor it to your liking. One option which is very 
useful is the autoindent option which allows the editor to automaticsilly supply leading white 
space to £ilign text. You can then use the "D key as a backtab and space and tab forward to align 
new code easily. 

Miscellaneous new useful featinres include an intelligent join (j) command which supplies white 
space between joined lines automatically, commands < and > which shift groups of lines, and the 
ability to filter portions of the buffer through commands such as sort. 

INVOCATION OPTIONS 

The following invocation options Eire interpreted by ex : 

- Suppress all interactive-user feedback. This is useful in processing editor scripts. 

—V Invokes vi 

Edit the file containing the tag and position the editor at its definition. 

Recover file after an editor or system crash. If file is not specified a list of all 
saved files will be printed. 

Readonly mode set, prevents accidentally overwriting the file. 

Begin editing by executing the specified editor search or positioning command. 

LISP mode; indents appropriately for lisp code, the () {} [[ and ]] commands in 
vi are modified to have meaning for lisp. 

-X Encryption mode; a key is prompted for allowing creation or editing of an 

encrypted file. 

The name argimaent indicates files to be edited. 

Ex States 

Command Normal and initial state. Input prompted for by : . Your kill character cancels 

partial commsind. 

Insert Entered by a i and c. Arbitrary text may be entered. Insert is normally ter- 

minated by line having only . on it, or abnormally with an interrupt. 

Visual Entered by vi, terminates with Q or "\. 

Ex cominand names and abbreviations 



-t tag 
-r file 

-R 

+ command 
-I 



abbrev 


ah 


next 


n 


imabbrev 


una 


append 


a 


number 


nu 


imdo 


u 


args 


ar 






immap 


unm 


change 


c 


preserve 


pre 


version 


ve 


copy 


CO 


print 


P 


visual 


vi 


delete 


d 


put 


pu 


write 


w 


edit 


e 


quit 


q 


xit 


X 


file 


f 


read 


re 


yank 


ya 
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global g recover 

insert i rewind 

join j set 

list 1 shell 

map source 

mark ma stop 



rec window 

rew escape 

se Ishift 

sh print next 

so resubst 

st rshift 



move 



substitute s 



Ex Command Addresses 



n 

$ 

+ 

+n 
% 



line n 

current 

last 

next 

previous 

n forward 

1,$ 



/pat 
?pat 
x-n 
x,y 



scroll 

next with pat 
previous with pat 
n before x 
X through y 
marked with x 
previous context 



< 

CR 
& 
> 
"D 



Initializing options 
EXINIT 
$HOME/.exrc 

./•exrc 
set X 
set nox 
set x=val 
set 

set all 
set I? 

Most useful options 
autoindent ai 

autowrite aw 



ignorecase 
lisp 


ic 


list 
magic 




number 


nu 


paragraphs 


para 


redraw 




scroll 




sections 


sect 


shiftwidth 


sw 


showmatch 


sm 


showmode 


smd 


slowopen 


slow 


window 




wrapscan 


ws 


wrapmargin 


wm 



place set's here in environment var. 

editor initialization file 

editor initialization file 

enable option 

disable option 

give value val 

show changed options 

show all options 

show value of option x 



supply indent 

write before changing files 

in scanning 

( ) { } are s-exp's 

print '1 for tab, $ at end 

. [ * special in patterns 

number lines 

macro nsunes which start .. 

simulate smart terminal 

command mode lines 

macro names ... 

for < >, and input *D 

to ) 8ind } as typed 

show insert mode in vi 

stop updates during insert 

visual mode lines 

around end of buffer? 

automatic line splitting 



Scanning pattern formation 

beginning of line 
$ end of line 

any character 
\< beginning of word 

\> end of word 

[str] any char in str 
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['str] ... not in str 

[x-y] ... between i and y 

* any niunber of preceding 

AUTHOR 

Vi and ex are based on software developed by the University of California, Berkeley California, 
Computer Science Division, Department of Electrical Engineering and Computer Science. 

FILES 

/usr/lib/*/* describes capabilities of terminals 

./.exrc editor startup file 

$HOME/.exrc editor st£irtup file 

/usr/lib/exstrings error messages 

/usr/lib/exrecover recover command 

/usr/lib/expreserve preserve command 

/tmp/Exnnnnn editor temporary 

/tmp/Rxnrmnn named buffer temporary 

/usr /preserve preservation directory 

SEE ALSO 

awk(l), ctags(l), ed(l), edit(l), grep(l), sed(l), vi(l), curses(3X), term(7), terminfo(4). 

CAVEATS AND BUGS 

The undo command causes all marks to be lost on lines changed and then restored if the marked 
lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. More than a screen full of 
output may result if long lines art present. 

File input/output errors do not print a name if the conunand line '-' option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used before exiting the editor. 

Null characters are discarded in input files and cannot appear in resultant files. 

INTERNATIONAL SUPPORT 

8-bit and 16-bit data, 8-bit filenames, messages. 
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NAME 

expand, unexpand - expand tabs to spaces, and vice versa 

SYNOPSIS 

expand [ -tabstop ] [ -tabl,tab2,...,tabn ] [ file ... ] 
unexpand [ -a ] [ file ... ] 

DESCRIPTION 

Expand processes the named files or the standard input writing the standard output with tabs 
changed into blanks. Backspace characters are preserved into the output and decrement the 
colmnn count for tab calculations. Expand is useful for pre-processing character files (before sort- 
ing, looking at specific columns, etc.) that contain tabs. 

If a single tabstop argiunent is given then tabs are set tabstop spaces apart instead of the default 
8. If multiple tabstops are given then the tabs are set at those specific colimins. 

Unexpand puts tabs back into the data from the standard input or the named files and writes the 
result on the standard output. By default only leading blanks and tabs are reconverted to maxi- 
mal strings of tabs. If the -a option is given, then tabs are inserted whenever they would 
compress the resultant file by replacing two or more characters. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arguments 

DESCRIPTION 

The arguments are tJiken as an expression. After evaluation, the result is written on the standard 
output. Terms of the expression must be separated by blanks. Characters special to the shell 
must be escaped. Note that is returned to indicate a zero value, rather than the null string. 
Strings containing blanks or other special characters should be quoted. Integer-valued argmnents 
may be preceded by a unary minus sign. Internally, integers £ire treated as 32-bit, 2's complement 
numbers. 

The operators and keywords are listed below. Characters that need to be escaped are preceded by 
\. The list is in order of increasing precedence, with equal precedence operators grouped within 
{ } symbols. 

expr \ I expr returns the first expr if it is neither null nor 0, otherwise returns the second 
expr. 

expr \& expr retmns the first expr if neither expr is null or 0, otherwise returns 0. 

expr { =, \>, \>=, \<, \<=, != } expr 

returns the result of an integer comparison if both argmnents are integers, other- 
wise returns the result of a lexical comparison (note that = and == are identi- 
cal, in that both test for equality). 

expr { +, - } expr 

addition or subtraction of integer-valued argimients. 

expr { \*, /,% } expr 

multiplication, division, or remainder of the integer-valued argimients. 

expr : expr The matching operator : compares the first argument with the second argument 

which must be a regular expression. Regular expression syntax is the same as 
that of ed{l), except that all patterns are "anchored" (i.e., begin with *) eind, 
therefore, " is not a special character, in that context. Normally, the matching 
operator returns the number of characters matched (0 on failure). Alternatively, 
the \( . . . \) pattern symbols can be used to return a portion of the first argu- 
ment. 

length expr The length of expr. 

substr expr expr expr 

Takes the substring of the first expr, starting at the character specified by the 
second expr for the length given by the third expr. 

index expr expr Retiu^s the position in the first expr which contains a character found in the 
second expr. 

match Match is a prefix operator equivalent to the infix operator :. 

EXAMPLES 

1. a=^expr $a -|- 1^ 

Adds 1 to the shell variable a. 

2. expr $a : '.*/\(.*\)' \l $a 

For $a equal to either "/usr/abc/file" or just "file", this example returns the last seg- 
ment of a path name (i.e., file). Watch out for / alone as an argument: expr will 
take it as the division operator (see BUGS below). 
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3. expr //$a : ' .*/\(.*\) ' 

This is a better representation of example 2. The addition of the // characters elim- 
inates any ambiguity about the division operator and simplifies the whole expression. 

4. expr $VAR : ' .* ' 

Returns the number of characters in SVAR. 

RETURN VALUE 

As a side effect of expression evaluation, expr returns the following exit values: 

if the expression is neither null nor 

1 if the expression is null or 

2 for invalid expressions. 

SEE ALSO 

ed(l), sh(l), test(l). 

DIAGNOSTICS 

syntax error for operator /operand errors 

non-numeric argument 

if arithmetic is attempted on such a string 

BUGS 

After argument processing by the shell, expr cannot tell the difference between an operator smd an 
operand except by the value. If $a is an =, the command: 

expr $a = ' = ' 

looks like: 

expr = = = 

as the arguments are passed to expr (and they will all be taken as the = operator). The following 
works: 

expr X$a = X= 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

111,1 

SYNOPSIS 

f77 [ options ] files 
fc [ options ] files 

DESCRIPTION 

F77 is the HP-UX FORTRAN 77 compiler. It accepts several types of file arguments, see the 
HARDWARE DEPENDENCIES section below for exceptions: 

(1) Arguments whose names end with .f are taken to be FORTRAN 77 source files. They are 
compiled, and each object file is left in the ciuxent directory in a file whose name is that of 
the source, with .o substituted for .f. (The .o file will not be created for a single source 
which is compiled and loaded, nor for any source which fails to compile correctly.) 

(2) Arguments whose names end with .o are passed on to the linker (W(l)) to be linked into the 
final program. 

Arguments can be passed to the compiler through the FCOPTS environment variable as well as on 
the command line. The compiler picks up the value of FCOPTS and places its contents b^ore any 
arguments on the command line. For example, 

FCOPTS=-v 
export FCOPTS 
fc -L prog.f 

is equiveilent to 

fc -V -L prog.f 

Options 

The following options are recognized: 

-c suppress linking and produce object (.o) files from source files. 

-C enable range checking (same as SOPTION RANGE ON). 

-D compile debug lines (source lines with a "D" or "d" in colmnn 1 are treated as 

comments by default). 

-g causes the compiler to generate additional information needed for the use of a 

symbolic debugger. (This option may be incompatible with optimization.) 

-12 make default size of integers and logicals INTEGER*2 and LOGlCAL*2 (same as 

JOPTION short). 

-14 make default size of integers and logicals INTEGER*4 and LOGICAL*4. This is 

the compiler's default. 

-K automatically SAVE all local variables in all subprograms. This option forces 

static storage for these variables in order to provide a convenient path for 
importing FORTRAN 66 and FORTRAN 77 programs which were written to 
depend on static allocation of memory (i.e. variables retaining their values 
between invocations of the respective program imits). 

-Ix causes the linker to search first in the library named by /lib/libz.a and then in 

/u8r/lib/libx.a. (See W(l).) 

-L write a program listing to stdout during compilation. 

-n causes the output file from the linker to be marked shared. 
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-N causes the output file from the linker to not be marked shared. 

-o outfile name the output file from the linker out file instead of a.out. 

-onetrip execute any DO loop at least once. 

— O invoke the assembly code optimizer. 

-p prepare object files for profiling (see proJ{l)). 

-q causes the output file from the linker to be marked demand load. 

— Q causes the output file from the linker to not be marked demand load. 

-8 causes the output of the linker to be stripped of symbol table information (see 

/d(l) and strip{l)). (This option is incompatible with symbolic debugging.) 

-S compile the named source files and leave the assembly language output in 

corresponding files whose names are suffixed with .s (no .o files are created). 

-t c,name substitute or insert subprocess c with name where c is one or more of an 

implementation-dependent set of identifiers indicating the subprocess(es). Works 
in two modes: 

1) if c is a single identifier, name represents the full path name of the new sub- 
process; 

2) if c is a set of identifiers, name represents a prefix to which the standard 
suffixes are concatenated to construct the full path names of the new sub- 
processes. 

One or more values that c can assume are: 

c compiler body (standard suffix is fllcomp) 

same as c 

/ linker (standard suffix is Id) 

For other values that c can assume, see the HARDWARE DEPENDENCIES 
section below. 

-u force types of identifiers to be implicitly imdeclared (same as specifying IMPLI- 

CIT NONE; no other IMPLICIT statements are permitted). 

-U use upper case for external names (default is lower case). 

-v enable the verbose mode, producing a step-by-step description of the compilation 

process on stderr. 

-w suppress warning messages (same as $OPTlON WARNINGS OFF). 

-w66 suppress warnings about FORTRAN 66 features used. 

-W c,argl[,arg2,...,argN] 

causes argl through argN to be handed off to subprocess c. The argi are of the 
form -argoption[,argvalue], where argoption is the name of an option recognized 
by the subprocess and argvalue is a separate argument to argoption where neces- 
sary. The values that c can assmne are those listed imder the -t option, as well 
as d (driver program) which has a special meaning explained below. 

The -W d option specification allows £idditional, implementation-specffic options to be recognized 
and passed through the compiler driver to the appropriate subprocesses (see -W above). For 
example, on the Series 500: 

-W d,-Q,dfile,-e 

will send the options -Q dfile and -e through the compiler driver. Fiui;hermore, a shorthand 
notation for this mechanism can be used by prepending + to the option name; as in: 
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+Q dfile +e 

which is equivalent to the previous option expression. Note that for simplicity this shorthand is 
applied to each implementation-specific option individually, and that the argvalue is no longer 
separated from the argoption by a comma (see -W). 

HARDWARE DEPENDENCIES 

Series 200, 300: 

Arguments whose names end with .c or .8 are taken to be C or assembly source programs 
and are compiled or assembled, producing .o files. 

Argimients whose names end with .r are taken to be ratfor{l) source programs. These are 
first transformed by the ratfor preprocessor, and then compiled by /77 producing .o files. 

The -t and -W option have additional values that c can assume: 
r ratfor preprocessor (standard suffix is ratfor) 

1 code generator (standard suffix is fl) 

2 optimizer (standard suffix is c2) 
a assembler (standard suffix is as) 

c compiler body (standard suffix is —plpassl—) 

Specifymg -Wl, -1 will cause source file line nmnbers to be printed as assembly code com- 
ments for debugging purposes. 

The -K option has two side-efiects: (a) all non-initialized variables are initialized to zero, 
and (b) the DATA statement may appear among executable statements. 

The -L option is not unplemented. 

The following option is supported: 

-Y enables 8- and 16-bit NLS support in strings and comments. In the default case, 

NLS is not enabled. The -Y option has an optional parameter specifying the 
16-bit language name. There must be no blanks between -Y and the language 
parameter. 

The implementation-specific options on the Series 200 and Series 300 are: 

-|-A causes the compiler to align data using "old" alignment rules where non- 

character items 4 bytes and larger are aligned on 2-byte boimdaries instead of 4- 
byte boimdaries. 

-|-b causes the MC68010 compiler to generate code for floating point operations that 

will use the 98635 floating point card if it is installed in the computer at run-time 
(if not installed, operations will be done in software). 

-|-B causes the compiler to treat the backslash character ( \ ) as a C-like escape char- 

acter. 

-|-f causes the MC68010 compiler to generate code for floating point operations that 

must use the 98635 floating point card. This code does not nm imless the float- 
ing point card is installed. 

-I-M causes the MC68020 compiler to NOT generate in-line code for the MC68881 

math coprocessor. Library routines will be referenced for matherr capability. 

+'N< secondaryX n> 

This option adjusts the size of internal compiler tables. The compiler uses fixed 
size arrays for certain internal tables. Secondary is one of the letters from the 
set {qsxcnaet}, and n is an integer value. Secondary and n are not optional. 
The table sizes can be re-specified using one of the secondsiry letters and the 
number n as follows: 
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q maximum size of equivalence table (default is 150 table entries). 

8 maximmn size of statement label table (default is 201 table entries). 

X maximum size of external symbol table (default is 200 table entries). 

c maximimi size of control statements table (default is 20 table entries). 

n maximimi size of the hash table of symbols (default is 401 table entries). 

a maximimi size of external label name storage table (default is 10000 

bytes). 

e maximum number of expression tree nodes (default is 1000 entries). 

t maximum size of external symbol storage table (default is 40000 bytes). 

+8 issue warnings for non-ANSI features (same as $OPTION ANSI ON). 

-I-U upper and lower case are distinguished (case is significant). Keywords are only 

recognized in lower case. 

-|-x causes the compiler to generate inline code for the MC68020 and MC68881. This 

is the default on MC68020 machines. 

-j-X causes the compiler to generate "generic" MC68010 code. The code will also run 

on MC68020 processors, but it will not take advantage of new architectural capa- 
bilities. This is the default on MC68010 machines. 

Series 500: 

The following options are not implemented: -O, -p, -S, -w66. 

The following option is supported: 

-Y enables 8- ajid 16-bit NLS support in strings and comments. In the default case, 

NLS is not enabled. 

The implementation-specific options on the Series 500 are: 

-|-e write errors to stderr. 

+F causes the compiler to generate information used by various program analysis 

programs. 

-|-Q dfile specify dfile as the option file. 

-1-8 issue warnings for non-ANSI features (same as JOPTION ANSI ON). 

-f-T causes the running program to issue a procedure traceback for runtime errors. 

-|-Vc put all COMMONS in the virtual data area. 

-|-Vd put all SAVE'd and initialized (DATA statement) variables in the virtual data 

area. 

-)-Vf put all FORMAT strings in the virtual data area. 

Series 800: 

The -w66 option is not implemented. 

The -O option has an optional parameter specifying the optimization level. A parameter of 
'1' causes only level 1 optimizations to be performed, £ind a paremieter of '2' causes all 
optimizations to be performed. The option — O is the same as -02. 

The implementation-specific options on the Series 800 are: 

-|-Q dfile specify dfile as the option file. 

-|-8 issue warnings for non-ANSI features (same as SGPTION ANSI ON). 
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+T 



causes the ninnine Droeram to issue a orocedure traceback for runtime errors. 



FILES 



Series 200, Series 300 
a.out 
/lib/c2 
/lib/c210 

/lib/c220 

/usr/lib/end.o 

/lib/fl 

/lib/fllO 

/lib/fl20 

/usr/lib/f77passl 
/usr/lib/f77passll0 

/usr/lib/f77pa8sl20 

file.c 

file.f 

file.o 

file.r 

file.s 

/lib/frtO.o 

/lib/libc.a 

/usr/lib/libF77.a 

/usr/lib/libI77.a 

/lib/libm.a 

/lib/mfrtO.o 

Series 500 

/usr/tmp/* 

a.out 

/usr/lib/end.o 

/usr/lib/f77conip 

file.f 

file.o 

/lib/frtO.o 

/lib/libF77.a 

/lib/libI77.a 

/lib/libc.a 

/lib/libm.a 

Series 800 
a.out 

/usr/lib/f77comp 
file.f 
file.o 

/lib/crtO.o 
/usr/lib/libcl.a 
/lib/libc.a 



linked executable output file 

assembly code optimizer 

assembly code optimizer (MC68010 version) 

linked to /usr/lib/c2 on MC68010 systems 

assembly code optimizer (MC68020 version) 

linked to /usr/lib/c2 on MC68020 systems 

symbolic debugger string bufi^er 

compiler pass 2 

compiler pass 2 (MC68010 version) 

linked to /usr/lib/fl on MC68010 systems 

compiler pass 2 (MC68020 version) 

linked to /usr/lib/fl on MC68020 systems 

compiler pass 1 

compiler pass 1 (MC68010 version) 

linked to /usr/lib/f77passl on MC68010 systems 

compiler pass 1 (MC68020 version) 

linked to /usr/lib/f77passl on MC68020 systems 

input file (C source file) 

input file (FORTRAN source file) 

object file 

input file [ratfor source file) 

input file (assembly source file) 

run-time startoff routine 

C library; See Section 3 of this manual 

intrinsic function library 

FORTRAN I/O library 

math library 

startoff with profiling 

temporeiry files used by the compiler; 

names are created by tmpnam{3S). 

linked executable output file 

symbolic debugger string buffer 

compiler 

input file (FORTRAN source file) 

object file 

runtime startup 

FORTRAN math library 

FORTRAN I/O library 

C library; See Section 3 of this manual 

math library 

linked executable output file 

compiler 

input file (FORTRAN source file) 

object file 

runtime startup 

FORTRAN math and I/O libraries 

C library; See Section 3 of this manual 
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/lib/libm.a math library 

AUTHOR 

F77 and fc were developed by the Hewlett-Packard Company. 

SEE ALSO 

as(l), asa(l), cc(l), ld(l), strip(l), matheiT(3M). 

DIAGNOSTICS 

The diagnostics produced by /77 are intended to be self-explanatory. If a listing is requested (-L 
option), errors are written to the listing file. If no listing is being generated, errors are written to 
stderr. 

Series 500: Errors will be written to both the listing file £ind stderr if the -L and -He options are 
both specified. Occasional messages may be produced by the linker. 

Series 800: Errors will be written to both the listing file and stderr if the -L option is specified 
and if stdout and stderr are not directed to the same place. 

WARNINGS 

The -8 option has a new meaning; use +b for non-ANSI warnings. 

Series 200, Series 300: The -U option has a new meaning; use -j-U for case sensitivity. 
The -|-k option has been removed for Series 200, Series 300 because it is the default. 
Series 500: The -Q dfile option has a new meaning; use -|-Q dfile to specify an option file. 

INTERNATIONAL SUPPORT 

8- and 16-bit data only in strings and comments, 8-bit filenames. 
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NAME 

factor, primes - factor a number, generate large primes 

SYNOPSIS 

factor [ number ] 

primes [ start [ stop ] ] 

DESCRIPTION 

When factor is invoked without an argiunent, it waits for a nmnber to be typed in. If you type in 
a positive number, it factors the niunber and print its prime factors; each one is printed the 
proper niunber of times. Then it waits for another number. It exits if it encounters a zero or any 
non-numeric character. 

If factor is invoked with an argument, it factors the niunber as above and then exits. 

Maximum time to factor is proportional to sqrt(n) and occurs when n is prime or the square of a 
prime. 

The largest number that can be dealt with by factor is 1.0el4. 

Primes prints prime numbers between a lower and upper bound. If primes is invoked without any 
arguments, it waits for two numbers to be typed in. The first number is interpreted as the lower 
bound, and the second as the upper bound. All prime numbers in the resulting inclusive range are 
printed. 

If start is specified, all primes greater than or equal to start are printed. If both start and stop are 
given, then all primes occurring in the inclusive range "start - stop" are printed. 

Start and stop values must be integers represented as long integers. 

If the stop value is omitted in either case, primes runs until either overflow occurs or it is stopped 
by typing interrupt. 

The largest niunber that can be dealt with by primes is 2,147,483,647. 

DIAGNOSTICS 

"Ouch" when the input is out of range, for garbage input, or when start is greater than stop. 
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NAME 

file - determine file type 

SYNOPSIS 

file [ -m mfile ] [ -c ] [ -f ffile ] arg ... 

DESCRIPTION 

File performs a series of tests on each argmnent in an attempt to classify it. If an argument 
appears to be ASCII, file examines the first 512 bytes and tries to guess its language. If an argu- 
ment is an executable a.out file, file will print the version stamp, provided it is greater than (see 
the description of the -V option in ld{l)). 

File uses the file /etc/magic to identify files that have some sort of magic number, that is, any file 
containing a numeric or string constant that indicates its type. Commentary at the beginning of 
/etc/magic explains its format. 

The -m option instructs file to use an alternate magic file. 

The -c flag causes file to check the magic file for format errors. This validation is not normally 
carried out for reasons of eflBciency. No file classification is done imder -c. 

-fffile specifies that ffile is a file containing a list of the files which are to be examined. File then 
classifies each file whose name appears in ffile. 

SEE ALSO 

ld(l). 
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NAME 

find - find files 

SYNOPSIS 

find path-name-list expression 

DESCRIPTION 

Find recursively descends the directory hierarchy for each path name in the path-name-list (i.e., 
one or more path names) seeking files that match a boolean expression written in the primaries 
given below. In the descriptions, the argument n is used as a decimal integer where -\-n means 
more than n, -n means less than n and n means exactly n. 

-name file True if file matches the current file name. Normal shell argimient syntax may 

be used if escaped (watch out for [, ? and *). 

-perm onum True if the file permission flags exactly match the octal nmnber onum (see 
chmod{l)). If onum is prefixed by a minus sign, more flag bits (017777, see 
stat{2)) become significant and the flags are compared: 

(flags&oniun)==onum 

-type c True if the type of the file is c, where c is b, c, d, p, n, or f for block special 

file, character special file, directory, fifo (a.k.a named pipe), network special file, 
or plain file respectively. 

-links n True if the file has n links. 

-user uname True if the file belongs to the user uname. If uname is nimieric and does not 
appear as a login name in the /etc/passwd file, it is taken as a user ID. 

-group gname True if the file belongs to the group gname. If gname is numeric and does not 
appear in the /etc/group file, it is taken as a group ID. 

-size n[c] True if the file is n blocks long. If n is followed by a c, the size is in characters. 

-atime n True if the file has been accessed in n days. The access time of directories in 

path-name-list is changed by find itself. 

-mtime n True if the file has been modified in n days. 

-ctime n True if the file has been changed in n days. 

-exec cmd True if the executed cmd returns a zero value as exit status. The end of cmd 

must be punctuated by an escaped semicolon. A command argument {} is 
replaced by the ciurent path name. 

-ok cmd Like -exec except that the generated command line is printed with a question 

mark first, and is executed only if the user responds by typing y. 

-print Always true; causes the current path name to be printed. 

-cpio device Always true; write the current file on device in cpio (4) format (5120-byte 
records). 

-newer file True if the current file has been modified more recently than the argument file. 

-depth Always true; causes descent of the directory hierarchy to be done so that all 

entries in a directory are acted on before the directory itself. This can be useful 
when find is used with cpto(l) to transfer files that are contained in directories 
without write permission. 

( expression ) True if the parenthesized expression is true (parentheses are special to the shell 
and must be escaped). 



Hewlett-Packard Company 



Version B.l, October 1986 



FIND(l) HP-UX FIND(l) 



-inum n True if the file has inode number n. 

-ncpio Same as -cpio but adds the -c option to cpio. 

The primaries may be combined using the following operators (in order of decreasing precedence): 

1) The negation of a primary (! is the imary not operator). 

2) Concatenation of primaries (the and operation is implied by the juxtaposition of two pri- 
maries). 

3) Alternation of primaries (-o is the or operator). 

The -type option also recognizes n as a test for a network special file. 

EXAMPLE 

To remove all files named a.out or *.o that have not been accessed for a week: 

find / \( -name a.out -o -name '*.o' \) -atime -1-7 -exec rm {} \; 
Note that the spaces delimiting the escaped parentheses are required. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

cpio(l), sh(l), test(l), stat(2), cpio(4), fs(4). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

findmsg, dumpmsg - create message catalog file for modification 

SYNOPSIS 

findmsg file ... 
dumpmsg file ... 

DESCRIPTION 

Findmsg extracts messages from C program source file and writes them to the standard output, 
along with set information. The source file lines from which the string literals are to be extracted 
must have nl—mag and " in the same line. There are foiu* cases to be handled: 

printf(nl msg(l, "message")); 

#define NLSMESS "message" /* nl msg 1 */ 

char nlsmessO = "message" /* nl msg 1 */ 

char *nlsmessO = { 

"message 1", /* nl msg 1 */ 

"message 2", /* nl msg 2 */ 



}; 

In each of the latter three cases, there are executable lines elsewhere which contain nL-msg in an 
executable form, along with the necessEuy reference. Only one message is allowed on each physical 
line. Each message must appear completely on one line along with the nl—msg token. 

Findmsg derives message catalog set numbers from soiurce lines which appear as: 

#deflne NL_SETN 1 

Typic£illy a single such line will appear toward the beginning of the source file. 

Dumpmsg dumps out messages which are stored in a message catalog file which was generated by 
the gencat{l) command. 

The output of either command is in the form: 

$set 1 

1 messagel\n 

2 message two\n 

Each message can then be changed as necessary, then processed by the gencat{l) command. 

AUTHOR 

Findmsg was developed by the Hewlett-Packard Company. 

SEE ALSO 

findstr(l), gencat(l), insertmsg(l), getmsg(3C). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

findstr - find strings for inclusion in message catalogs 

SYNOPSIS 

flndstr file ... 

DESCRIPTION 

Findstr examines files of C source code for imcommented string constants, which it places along 
with the surroimding quotes on the standard output, preceding each by the file name, start posi- 
tion, and length. This information will be used by insertmsg. 

SEE ALSO 

insertmsg(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

fixman - fix manual pages for faster viewing with man(l) 

SYNOPSIS 

fixman 

DESCRIPTION 

This shell script processes all ordinary files under /usr/man/cat* to unexpand all possible spaces 
to tabs and remove all {character, backspace} pairs. Such pairs usually exist to cause overstrik- 
ing or imderscoring for printer output. They only slow down man(l), and use up significant 
amoimts of disk space. The script should be run after running catman(lM) to rebuild all cat-able 
manual entries from pre-nroff forms. 

The script does not remove duplicate blank lines, so all files remain a multiple of one page (66 
lines) long and can still be passed directly to /p(l). (Note that man(l) normally uses rmnl{l) to 
accomplish this removal.) 

To insure success, the script should be run by the super-user. It can take two to three hours to 
complete. As a side-eflfect, file ownerships and permissions may be changed. 



FILES 



/usr/man/cat* Directories containing post-nrofF 
versions of manual entries. 



AUTHOR 

Fixman was developed by the Hewlett-Packard Company. 

SEE ALSO 

catman(lM), chmod(l), expand(l), lp(l), man(l), mv(l), rmnl(l), sed(l). 
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NAME 

fold - fold long lines for finite width output device 

SYNOPSIS 

fold [ -width ][ file ... ] 

DESCRIPTION 

Fold is a filter which will fold the contents of the specified files, or the standard input if no files 
are specified, breaking the lines to have maximum width width. The default for xvidth is 80. Width 
should be a multiple of 8 if tabs are present, or the tabs should be expanded using expand[i) 
before coming to fold. 

SEE ALSO 

expand(l) 

BUGS 

If underlining is present it may be messed up by folding. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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FnAME 

from - who is my mail from? 

SYNOPSIS 

from [ -8 sender ] [ user ] 

DESCRIPTION 

From prints out the mail header lines in yovir mailbox file to show you who your mail is from. If 
xiser is specified, then user's mailbox is examined instead of yom- own. If the -s option is given, 
then only headers for mail sent by sender are printed. 

FILES 

/usr/mail/* 

AUTHOR 

From was developed by the University of Califomia, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

biff(l), mail(l), prmail(l). 
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NAME 

ftio - faster tape I/O 

SYNOPSIS 

ftio -o I O [ cvaxEpLM ] [ -N datefile ] [ -Z nobufs ] [ -B blksize ] [ -S script ] [ - 
K comment } [ -L filelist ] tapedev [ pathnames ] [ -F ignorenames ] 

ftio -i I I [ cdmtuvfxAPEpMR ] [ -Z nobufs ] [ -B blksize ] [ -S script ] tapedev [ 
patterns ] 

ftio -g [ V ] tapedev [ patterns ] 

DESCRIPTION 

Ftio is a tool designed specifically for copying files to 9 track magnetic tape drives. It should per- 
form faster than either cpto(l) or tar{l) in comparable situations. Ftio uses two processes (one 
reading/writing the file system, one writing/reading the tape device) with large amounts of shared 
memory between the processes, as well as a large block size for reading and writing to the tape. 

The tool is compatible with cpio in that output from cpio{l) is always readable by ftio, and out- 
put from ftio is readable with exceptions by cpio{l). See the CPIO COMPATIBILITY section 
for a more detailed explanation. 

Ftio with the -o (copy out) option copies files onto tapedev together with path name and status 
information. If pathnames was specified, ftio recursively descends pathnames looking for files, and 
copies those files onto tapedev, if not, ftio reads the standard input to obtain a list of path names 
to copy. In addition to copying the files onto the tape set, ftio will generate, for each tape in the 
tape set, a tape header containing the current tape number, machine nodename and type, operat- 
ing system name, release and version numbers (all from uname{2)), username of the backup initia- 
tor, time and date of the backup, number of consecutive times the current media has been used, a 
comment field, and other items used internally by ftio. The tape header is separated from the 
main body of the archive by an end of file mark. The tape header can be read by invoking cat{l) 
with the device file name as the first argument. 

When invoked using ftio -O, the default behavior is the same as for ftio -ocva. However, if the 
file .ftiorc exists in the user's home directory, ftio will open this file, and scan for lines preceded 
by 0=. Options defined on matching lines are passed to ftio as if they had been passed in the ori- 
ginal command. See the EXAMPLES section. 

Ftio with the -i (copy in) option extracts files from tapedev, which is assiuned to be the product 
of a previous ftio -o operation. Only files with names that match patterns are selected. Patterns 
are given in the name-generating notation of sh{l). In patterns, meta-characters ?, *, and [...] 
match the slash / character. Multiple patterns may be specified and if no patterns are specified, 
the default for patterns is * (i.e., select all files). The extracted files are conditionally created and 
copied into the current directory tree based upon the options described below. The permissions of 
the files will be those of the previous -o operation. 

When invoked using ftio -I, the default behavior is the same as for ftio -icdmv. However, if the 
file .ftiorc exists in the user's home directory, ftio will open this file, and scan for lines preceded 
by I=. Options defined on matching lines are passed to ftio as if they had been passed in the ori- 
ginal conunand. See the EXAMPLES section. 

Ftio with the -g option reads the file list on tapedev. If patterns is specified, only file names which 
match will be printed. Note that file names are always preceded by the volume that ftio expected 
the file to be on when the file list was created, and therefore only the last voliune is valid in this 
respect. 

Options 

The meanings of the available options are: 
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a After files have been copied out to tape, reset the access time so that it appears the file 

had not been accessed by ftio. 

d When restoring files, directories are to be created as needed. 

c Write header information in ASCII character form for portability. 

t Print only a table of contents of the input. No files are created, read, or copied. 

u Copy unconditionally (normally, an older file will not replace a newer file with the same 

name). 

X Save or restore device special files. Ftio will use mknod{2) to recreate these files during a 

restore operation. Thus, this option is restricted to the super-user. This is intended for 
intrasystem (backup) use. Restoring device files onto a different system can be very 
dangerous. 

V Verbose: causes a list of file names as well as tape headers to be printed. When used 

with the t option, the table of contents looks like the output of Is -1 command (see ls{l)). 

m Retain previous file modification time and ownership of file. Restoration of modification 

time is ineffective on directories that are being restored. 

f Copy in all files except those that match patterns. 

A Print all file names foimd on the archive, noting which files have been restored. This is 

useful when the user is restoring selected files, but wants to know which (if any) files are 
on the tape. 

P On restoration, use prealloc{2) to pre-allocate disk space for the file, this vastly improves 

the localization of file fragments. 

E When archiving, all files with absolute path names are archived with a path name relative 

to the root directory, i.e., all files whose name starts with '/' have the first '/' removed. 
On restoration, any files in the archive that have an absolute path name, have the leading 
7' removed from the path name and are restored relative to the current directory. 

p The number of blocks transferred, the total time taken (excluding tape rewind and change 

reel time), and the effective transfer rate, calculated from these figures, is printed at the 
end of the backup. If the option is given twice, this will be done at the end of each tape. 

Z The next argument (nobufs) specifies the number of blksize chunks of memory to use as 

buffer space between the two processes, where blksize is the size of blocks written to the 
tape. More chunks is usually better, but a point is reached where no improvement is 
gained, and in fact performance may deteriorate as buffer space is swapped out of main 
memory. A default value of 16 is set, but the use of 32 or 64 may improve performance if 
your system is relatively unloaded. We recommend performing a backup with the system 
in single user mode. 

B The next argument {blksize) specifies the size (in bytes) of blocks written to tape. This 

number may end with "k", specifying multiplication by 1024. Larger blocks will generally 
improve performance, as well as improving tape usage. The maximum block size allowed 
is limited by the tape drive being used. A default of 16384 bytes is set, as this is the max- 
imum block size on most Hewlett-Packsird tape drives. 

S The next argument {script) specifies a command which is invoked every time a tape is 

completed in a multi-tape backup. The command is invoked by sh{\), with the following 
arguments: script tape— no user— name. Script is the string script specified by the -S 
option, tape— no is the number of the tape required, and user— name is the user who 
invoked ftio. Typically, the string script specifies a shell script which is used to notify the 
user that a tape change is required. 

K The next argimient {comment) specifies a comment to be placed in the ftio tape header. 

F Argmnents following -F specify patterns that should not be copied to the tape. The same 

rules apply for ignorenames as do for patterns, see the previous description for ftio -i. 

N Only files that are newer than the file specified in the following argument {datefile) are 

copied to tape. 

L If the L option is specified and pathnames have been given, ftio will perform the file 

search sind generate a list of files to back up prior to £ictually commencing the backup. 
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This list is then appended to the tape header of each tape in the backup, as a hst of files 
that ftio attempted to fit onto this tape. By definition, the last tape in the backup will 
contain a catalog of where the files are in the archive set. If pathnames is not specified, 
the file list is taken from standard input before the backup begins. The file list is also left 
in the current directory as the file ftio.list, if the L has been used with an argument 
{filelist), then the argument specifies the output file. In addition to generating file lists, 
the L option implements tape checkpointing, allowing the backup to restart from a write 
failure on a bad medium. 

M Do not generate or expect tape headers, and change the default block size to 5120 bytes. 

This allows for full compatibility with cpto(l). See discussion in CPIO COMPATIBIL- 
ITY section. 

R Ftio will automatically resync when it gets out of phase. This is useful when restoring 

from a multi tape backup on tapes other than the first. The default behavior is that ftio 
will ask the user if resyncing is required. 

When the end of the tape is reached, ftio will invoke script if the -S option has been exercised, 
rewind the current tape, then ask the user to mount the next tape. 

If you want to pass one or more metacharacters to ftio without the shell expanding them, be sure 
to protect them by either preceding each of them with a backslash (e.g., /usr\*), or enclosing in 
protection quotes (e.g., '/usr*'). 

Device files written with the -o option (e.g. /dev/tty03) will not transport to other implementa- 
tions of HP-UX. 

EXAMPLES 

The first example below copies the entire contents of the file system (including special files) onto 
the tape drive /dev/rmt/Oh: 

ftio -ox /dev/rmt/Oh / 

The following example will restore all the files on /dev/rmt/Oh, relative to the current directory: 

ftio -idxE /dev/rmt/Oh 

The following example demonstrates how to list the contents of a backup set created using ftio 
-o. 

ftio -itv /dev/rmt/Oh 

Note that use of the -v option will give a more detailed listing, and will display the contents of 
tape headers. 

The next example demonstrates the use of the .ftiorc file. The user has a .ftiorc file in their 
home directory with the following contents: 

# Example .ftiorc file. 

1= cdmuvEpp -B 16k -S /usr/local/bin/ftio.change 

0= cavEpp -Z 8 -B 16k -S /usr/local/bin/ftio.change 

Ftio is invoked with the following command line to backup the users home directory and the sys- 
tem binary directory: 

ftio -O /dev/rmt/Oh /user/my _home /bin 

Because the -O option has been specified, the .ftiorc will be checked for additional options. In 
this case, character headers will be generated, access times will be reset, a listing of the files copied 
will be printed to standard output, all file names will be copied to /dev/rmt/Oh with path 
names relative to '/', performance data will be printed when the backup is complete (and at every 
tape change), and if the backup goes beyond one media the script "/usr/local/bin/ftio.change" 
will be invoked by ftio after each media is completed. 
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SIGNAL HANDLING (WARNING) 

Ftio uses System V shared memory and semaphores for its operation. The resources committed to 
these fimctions are not automatically freed by the system when the process terminates. Ftio will 
do this only when it terminates normally, or when it terminates after receiving one the following 
signals: SIGHUP, SIGINT, SIGTERM. Any other signal will be handled in the default manner 
described by stgnal{2). Note that the behavior for SIGKILL, is to terminate the process without 
delay. Thus, if ftio receives a SIGKILL signal (as might be produced by the indiscriminate use of 
kill(l) -9), system resources used for shared memory and semaphores will not be returned to the 
system. If it becomes necessary to terminate an invocation of ftio, use kill -15. Current system 
usage of shared memory and semaphores can be checked using ipcs(l). Committed resources can 
be removed using ipcrm(l). 

CPIO COMPATIBILITY 

Ftio uses the same archive format as cpio{l). However, the default behavior of ftio is to create 
tape headers and to use a tape block size of 16k bytes. Cpio(l) by default uses 512 byte blocks, 
when used with the -B option, cpio{l) uses 5120 byte blocks. To achieve full compatibility with 
cpio(l) in either input or output mode, the user should specify the the -M option. Ftio -oM will 
create a single or multi taj)e archive which has no tape headers, and by default the same block 
size as cpio -[o|i]B. An archive created by a cpio -oB command may be restored using ftio 
-iM. If the -M option oi ftio is combined with a -B 512 block size specification, full compatibility 
with cpio -[oli] (no -B) is achieved. 

AUTHOR 

Ftio was developed by HP. 

SEE ALSO 

cpio(l), find(l), cpio(4), ipcs(l), ipcrm(l), mt(7). 
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NAME 

gencat - generate a formatted message catalog file 

SYNOPSIS 

gencat catflle file ... 

DESCRIPTION 

Gencat merges message somrce files into a formatted catfile which can be accessed by getTnsg{ZC). 
If catfile does not exist it will be created. If catfile does exist its messages will be included in the 
new catfile miless set and message numbers collide, in which case the new supersedes the old. The 
files consist of sets of messages along with comments. 

The format for message source in the files has been designed to include compatibility with MPE 
and RTE. A line which begins with a dollar sign followed by a blank denotes a comment and 
may appear anywhere in a file. 

A message set consists of a line of the form 

$setn [comment] 
followed by lines of the form 

m message-text 

where n denotes the set nmnber (1-255) and m the message number (1-32767). Typically the set 
number will be used to identify the language, while the message nmnber denotes which string 
firom a given program is wanted. Message-text is a C string, including white space and '\' escapes, 
without the surrounding quotes. A $8et line may optionally contain comment text following the 
set number. Set numbers and message niraibers must be in ascending order but need not be con- 
tiguous. 

If a message source line has a nmnber but no text then the existing message with this munber is 
deleted from the catalog. 

To delete an entire message set the directive 

$DELSET set^name 

may be placed at the beginning of a line between sets. 

SEE ALSO 

findmsg(l), insertmsg(l), getmsg(3C). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

get - get a version of an SCCS file 

SYNOPSIS 

get [-rSID] [-ccutofi] [-^] [-b] [-ilist] [-xlist] [-k] H[p]] [-p] [-«] [-m] [-n] [-g] [-t] 
[-wstring] [-aseq-no.] file . . . 

DESCRIPTION 

Get generates an ASCII text file from each named SCCS file according to the specifications given 
by its keyletter arguments, which begin with -. The argmnents can be specified in any order, but 
all keyletter argmnents apply to all named SCCS files. If a directory is named, get behaves as 
though each file in the directory were specified as a named file, except that non-SCCS files (last 
component of the path name does not begin with s.) and imreadable files are silently ignored. If 
a name of - is given, the staindard input is read; each line of the standard input is taken to be the 
name of an SCCS file to be processed. Again, non-SCCS files and unreadable files are silently 
ignored. 

The generated text is normally written into a file called the g-file whose name is derived from the 
SCCS file name by simply removing the leading s.; (see also FILES, below). 

Each of the keyletter arguments is explained below as though only one SCCS file is to be pro- 
cessed, but the eff'ects of any keyletter argmnent applies independently to each named file. 

-rSID The 5CCS /Dentification string (SID) of the version (delta) of an SCCS file to be 

retrieved. Table 1 below shows, for the most useful cases, what version of an 
SCCS file is retrieved (as well as the SID of the version to be eventually created 
by delta{l) if the -e keyletter is also used), as a function of the SID specified. 

-ccutoff Cutoff d&te-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after the specified cutoff 
date-time are included in the generated ASCII text file. Units omitted from the 
date-time default to their maximmn possible values; that is, -c7502 is 
equivalent to -c750228235959. Any number of non-numeric characters may 
separate the various 2-digit pieces of the cutoff date-time. This feature allows 
one to specify a cuio^date in the form: "-c77/2/2 9:22:25". Note that this 
implies that one may use the %E% and %U% identification keywords (see below) 
for nested gets within, for example, a send{l) command: 

~!get "-c%E% %U%" s.file 

-€ Indicates that the get is for the purpose of editing or making a change (delta) to 

the SCCS file via a subsequent use of delta {I). The -e keyletter used in a get for 
a particular version (SID) of the SCCS file prevents further gets for editing on the 
same SID until delta is executed or the j (joint edit) flag is set in the SCCS file 
(see admin (1)). Concm-rent use of get -e for different SIDs is always allowed. 

If the g-file generated by get with an -e keyletter is £iccidentally ruined in the 
process of editing it, it may be regenerated by re-executing the get conunand 
with the -k keyletter in place of the -e keyletter. 

SCCS file protection specified via the ceiling, floor, and authorized user list stored 
in the SCCS file (see admin(l)) are enforced when the -e keyletter is used. 

-b Used with the -e keyletter to indicate that the new delta should have an SID in 

a new branch as shown in Table 1. This keyletter is ignored if the b flag is not 
present in the file (see admm(l)) or if the retrieved delta is not a leaf delta. (A 
leaf delta is one that has no successors on the SCCS file tree.) 
Note: A branch delta may always be created from a non-leaf delta. 
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-Hist A list of deltas to be included (forced to be applied) in the creation of the gen- 

erated file. The list has the following syntax: 

<list> ::= <range> I <list> , <range> 
<range> ::= SID I SID - SID 

SID, the sees Identification of a delta, may be in any form shown in the "SID 
Specified" colimin of Table 1. Partial SIDs are interpreted as shown in the "SID 
Retrieved" colimm of Table 1. 

-jclist A list of deltas to be excluded (forced not to be applied) in the creation of the 

generated file. See the -i keyletter for the list format. 

-k Suppresses replacement of identification keywords (see below) in the retrieved 

text by their value. The -k keyletter is implied by the -e keyletter. 

-l[p] Causes a delta summary to be written into an l-file. If -Ip is used then an l-file 

is not created; the delta summary is written on the standard output instead. See 
FILES for the format of the l-file. The user must have read permission for the s- 
file in order to use the -1 option. 

-p Causes the text retrieved from the SCCS file to be written on the standard out- 

put. No g-file is created. All output which normally goes to the standard out- 
put goes to file descriptor 2 (stderr) instead, unless the -s keyletter is used, in 
which case it disappears. 

-s Suppresses all output normally written on the standard output. However, fatal 

error messages (which always go to file descriptor 2) remain unaffected. 

-m Causes each text line retrieved from the SCCS file to be preceded by the SID of 

the delta that inserted the text line in the SCCS file. The format is: SID, fol- 
lowed by a horizontal tab, followed by the text line. 

-n Causes each generated text line to be preceded with the %M% identification key- 

word value (see below). The format is: %M% vdue, followed by a horizontal 
tab, followed by the text line. When both the -m and -n keyletters are used, 
the format is: %M% value, followed by a horizontal tab, followed by the -m 
keyletter generated format. 

-g Suppresses the actual retrieval of text from the SCCS file. It is primarily used to 

generate an l-file, or to verify the existence of a particular SID. 

-t Used to access the most recently created ("top") delta in a given release (e.g., 

-rl), or release and level (e.g., -rl.2). 

-w string Substitute string for all occurrences of @%M% when ge^ng the file. 

-aseq-no. The delta sequence nmnber of the SCCS file delta (version) to be retrieved (see 

sccsfile{'i)). This keyletter is used by the com6(l) command; it is not a gen- 
erally useful keyletter, and users should not use it. If both the -r and -a 
keyletters are specified, the -a keyletter is used. Care should be taken when 
using the -a keyletter in conjimction with the -e keyletter, as the SID of the 
delta to be created may not be what one expects. The -r keyletter can be used 
with the -a and -e keyletters to control the naming of the SID of the delta to be 
created. 

For each file processed, get responds (on the standard output) with the SID being accessed and 
with the nmnber of lines retrieved from the SCCS file. 

If the -e keyletter is used, the SID of the delta to be made appears after the SID accessed and 
before the number of lines generated. If there is more than one named file or if a directory or 
standard input is named, each file name is printed (preceded by a new-line) before it is processed. 
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If the -i keyletter is used included deltas are listed following the notation "Included"; if the -x 
keyletter is used, excluded deltas are listed following the notation "Excluded". 



TABLE 1. Determination of SCCS Identification String 


SID* 


-b Keyletter 


Other 


SID 


SID of Delta 


Specified 


Usedt 


Conditions 


Retrieved 


to be Created 


nonet 


no 


R defaults to mR 


mR.mL 


mR.(mL+l) 


nonet 


yes 


R defaults to mR 


mR.mL 


mR.mL.(mB+l).l 


R 


no 


R > mR 


mR.mL 


R.1*** 


R 


no 


R = mR 


mR.mL 


mR.(mL+l) 


R 


yes 


R > mR 


mR.mL 


mR.mL.(mB+l).l 


R 


- 


R < mR and 
R does not exist 
Tnmk succ.# 


hR.mL** 


hR.mL.(mB+l).l 


R 


- 


in release > R 
and R exists 


R.mL 


R.mL.(mB+l).l 


R.L 


no 


No tnmk succ. 


R.L 


R.(L+1) 


R.L 


yes 


No trunk succ. 


R.L 


R.L.(mB+l).l 


R.L 


- 


Trunk succ. 
in release > R 


R.L 


R.L.(mB+l).l 


R.L.B 


no 


No branch succ. 


R.L.B.mS 


R.L.B.(mS+l) 


R.L.B 


yes 


No branch succ. 


R.L.B.mS 


R.L.(mB+l).l 


R.L.B.S 


no 


No branch succ. 


R.L.B.S 


R.L.B.(S+1) 


R.L.B.S 


yes 


No branch succ. 


R.L.B.S 


R.L.(mB+l).l 


R.L.B.S 


- 


Branch succ. 


R.L.B.S 


R.L.(mB+l).l 



* "R", "L", "B", and "S" are the "release", "level", "branch", and "sequence" components 
of the SID, respectively; "m" means "maximmn". Thus, for example, "R.mL" means "the 
maximum level number within release R"; "R.L.(mB+l).l" means "the first sequence 
number on the new branch (i.e., maximimi branch number plus one) of level L within release 
R". Note that if the SID specified is of the form "R.L", "R.L.B", or "R.L.B.S", each of the 
specified components mttst exist. 

** "hR" is the highest existing release that is lower than the specified, nonexistent, release R. 
*** This is used to force creation of the first delta in a new release. 

# Successor. 

t The -b keyletter is effective only if the b flag (see arfmin(l)) is present in the file. An entry 
of - means "irrelevant". 

t This case applies if the d (default SID) flag is not present in the file. If the d flag is present 
in the file, then the SID obtained from the d flag is interpreted as if it had been specified on 
the command line. Thus, one of the other cases in this table applies. 

IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved from the SCCS file by replacing 
identification keywords with their value wherever they occur. The following keywords may be 
used in the text stored in an SCCS file: 

Keyword Value 

%M% Module name: either the value of the m flag in the file (see admin{l)), or if absent, 

the name of the SCCS file with the leading s. removed. 
%I% SCCS identification (SID) (%R%.%L%.%B%.%S%) of the retrieved text. 
%R% Release. 
%L% Level. 
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%B% Branch. 

%S% Sequence. 

%D% Current date (YY/MM/DD). 

%H% Current date (MM/DD/YY). 

%T% Current time (HH:MM:SS). 

%E% Date newest applied delta was created (YY/MM/DD). 

%G% Date newest applied delta was created (MM/DD/YY). 

%U% Time newest applied delta was created (HH:MM:SS). 

%Y% Module type: value of the t flag in the SCCS file (see admin{l)). 

%F% SCCS file name. 

%P% Fully qualified SCCS file name. 

%Q% The value of the q flag in the file (see odmm(l)). 

%C% Current line nmnber. This keyword is intended for identifying messages output by the 

program such as "this should not have happened" tjrpe errors. It is not intended to be 

used on every line to provide sequence numbers. 
%Z% The 4-character string @(#) recognizable by what{l). 
%W% A shorthand notation for constructing what{l) strings for HP-UX system program files. 

%W% = %Z%%M%<horizontal-tab>%I% 
%A% Another shorthand notation for constructing what{l) strings for non-HP-UX system 

program files. 

%A% = %Z%%Y% %M% %I%%Z% 

Several auxiliary files may be created by get. These files are known generically as the g-file, I- file, 
p-file, and z-file. The letter before the hyphen is called the tag. An auxiliary file name is formed 
from the SCCS file name: the last component of all SCCS file names must be of the form 
s.module-name, the auxiliary files are named by replacing the leading s with the tag. The g-file is 
an exception to this scheme: the g-file is named by removing the s. prefix. For example, 8.xyz.c, 
the auxiliary file names would be xyz.c, Lxyz.c, p.xyz.c, and z.xyz.c, respectively. 

The g-file, which contains the generated text, is created in the current directory (imless the -p 
keyletter is used). A g-file is created in all cases, whether or not any lines of text were generated 
by the get. It is owned by the real user. If the -k keyletter is used or implied its mode is 644; 
otherwise its mode is 444. Only the real user need have write permission in the current directory. 

The l-file contains a table showing which deltas were applied in generating the retrieved text. 
The l-file is created in the current directory if the -1 keyletter is used; its mode is 444 and it is 
owned by the real user. Only the real user need have write permission in the current directory. 

Lines in the l-file have the following format: 

a. A blank character if the delta was applied; 

* otherwise. 

b. A blank character if the delta was applied or was not applied and ignored; 

* if the delta was not applied and was not ignored. 

c. A code indicating a "special" reason why the delta was or was not applied: 

"I": Included. 

"X": Excluded. 

"C": Cut off (by a -c keyletter). 

d. Blank. 

e. SCCS identification (SID). 

f. Tab character. 

g. Date and time (m the form YY/MM/DD HH:MM:SS) of creation, 
h. Blank. 

i. Login name of person who created delta. 
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The conunents and MR data follow on subsequent lines, indented one horizontal tab char- 
acter. A blank line terminates each entry. 

The p-file is used to pass information resulting from a get with an -e keyletter along to delta. Its 
contents are also used to prevent a subsequent execution of get with an -e keyletter for the same 
SID until delta is executed or the joint edit flag, j, (see admin{l)) is ^t in the SCCS file. The p- 
file is created in the directory containing the SCCS file and the effective user must have write per- 
mission in that directory. Its mode is 644 and it is owned by the effective user. The format of 
the p-file is: the gotten SID, followed by a blank, followed by the SID that the new delta will have 
when it is made, followed by a blank, followed by the login name of the real user, followed by a 
blank, followed by the date-time the get was executed, followed by a blank and the -i keyletter 
argmnent if it was present, followed by a blank and the -x keyletter argument if it was present, 
followed by a new-line. There can be an arbitrary munber of lines in the p-file at any time; no 
two lines can have the same new delta SID. 

The z-file serves as a lock-out mechanism against simultaneous updates. Its contents are the 
binary (2 bytes) process ID of the command (i.e., get) that created it. The z-file is created in the 
directory containing the SCCS file for the duration of get. The same protection restrictions as 
those for the p-file apply for the z-file. The z-file is created mode 444. 

SEE ALSO 

admin(l), delta(l), help(l), prs(l), what(l), 8ccsfile(4). Source Code Control System User's Guide 
in HP-UX Concepts and Tutorials 

DIAGNOSTICS 

Use help{l) for explanations. 

WARNINGS 

If the effective user has write permission (either explicitly or implicitly) in the directory containing 
the SCCS files, but the real user does not, then only one file may be named when the -e keyletter 
is used. 

An 1-file cannot be generated when -g is used. In other words, -g -1 does not work. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

getopt - parse command options 

SYNOPSIS 

getopt optstring args 

DESCRIPTION 

Getopt is used to break up options in command lines for easy parsing by shell procedures and to 
check for legal options. Optstring is a string of recognized option letters (see getopt (SC)); if a 
letter is followed by a colon, the option is expected to have an argument which may or may not 
be separated from it by white space. The special option — is used to delimit the end of the 
options. If it is used explicitly, getopt will recognize it; otherwise, getopt will generate it; in either 
case, getopt will place it at the end of the options. The positional parameters ($1 $2 . . . ) of the 
shell are reset so that each option is preceded by a - and is in its own positional parameter; each 
option argument is also parsed into its own positional parameter. 

The most common use of getopt is in the shell's set command (see the example below). There, 
getopt converts the command line to a more easily parsed form. Getopt writes the modified com- 
mand line to the standard output. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can 
take the options a or b, as well as the option o, which requires an argument: 

set -- 'getopt abo: $*' 

if [ $? != ] 

then 

echo $USAGE 

exit 2 
fi 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 

-o) 0ARG=$2; shift 2;; 

— ) shift; break;; 

esac 
done 

This code will accept any of the following as equivalent: 

cmd -aoarg file file 
cmd -a -o arg file file 
cmd -oarg -a file file 
cmd -a -oarg -- file file 

SEE ALSO 

sh(l), getopt(3C). 

DIAGNOSTICS 

Getopt prints an error message on the standard error when it encoimters an option letter not 
included in optstring. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

getprivgrp - get special attributes for group 

SYNOPSIS 

getprivgrp [ -g I group-name ] 

DESCRIPTION 

Getprivgrp lists the access privileges of privileged groups set by setprivgrp{lM). When a group 
name is supplied access privileges are listed for that group only. When -g is supplied access 
privileges are listed which have been granted to all groups. Otherwise, access privileges are listed 
for all privileged groups of which the caller is a member. The super-user is considered to be a 
member of all groups. Access privileges include RTPRIO, MLOCK, and CHOWN. 

AUTHOR 

Getprivgrp was developed by HP. 

SEE ALSO 

getprivgrp(2), setprivgrp(lM), privgrp(4). glossary 
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NAME 

grep, egrep, fgrep - search a file for a pattern 

SYNOPSIS 

Levels B and C 

grep [ options ] expression [ files ] 

Level C Only 

egrep [ options ] [ expression ] [ files ] 

fgrep [ options ] [ strings ] [ files ] 

DESCRIPTION 

Commands of the grep family search the input files (standard input default) for lines matching a 
pattern. Normally, each line found is copied to the standard output. Grep patterns are limited 
regular expreasiona in the style of ed(l); it uses a compact non-deterministic algorithm. Egrep 
patterns are full regular expressions; it uses a fast deterministic algorithm that sometimes needs 
exponential space. Fgrep patterns are fixed strings; it is fast and compact. The following options 
are recognized: 

-V All lines but those matching are printed. 

-X (Exact) only lines matched in their entirety are printed {fgrep only). 

-c Only a count of matching lines is printed. 

— i Ignore upper/lower case distinction during comparisons. 

-1 Only the names of files with matching lines are listed (once), separated by new-lines. 

-n Each line is preceded by its relative line ntunber in the file. 

-b Each line is preceded by the block number on which it was found. This is sometimes useful 

in locating disk block nmnbers by context. 
-8 The error messages produced for nonexistent or imreadable files are suppressed {grep only). 
-e expression 

Same as a simple expression argmnent, but useful when the expression begins with a - 

(does not work with grep). 
-f file The regular expression {egrep) or strings list {fgrep) is taken from the file. 

In all cases, the file name is output if there is more than one input file. C6ire should be taken 
when using the characters $, *, [, *, |, (, ), eind \ in expression, because they are also meaningful 
to the shell. It is safest to enclose the entire expression argument in single quotes ' . . . ' . 

Fgrep searches for lines that contain one of the strings , each of which is separated from the next 
by a new-line. 

Egrep accepts regular expressions as in ed(l), except for \( and \), with the addition of: 

1. A regular expression followed by -f- matches one or more occurrences of the regular expres- 
sion. 

2. A regular expression followed by ? matches or 1 occurrences of the regular expression. 

3. Two regular expressions separated by | or by a new-line match strings that are matched by 
either. 

4. A regular expression may be enclosed in parentheses ( ) for grouping. 

The order of precedence of operators is [ ], then *1 +, then concatenation, then | and new-line. 

EXAMPLES 

The following example searches two files, finding all lines containing occiurences of £iny of four 
strings: 

fgrep 'if 

then 

else 

fi' script 1 script2 
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Note that the single quotes are necessary to tell fgrep when the strings have ended and the file 
names have begun. 

This example searches for a new-line in a file: 

grep -V '\. ' filel 

The -V option causes grep to print those fines that do not match the expression. Since a new-line 
cannot be matched with dot, only lines containing a new-line are printed. 

SEE ALSO 

ed(l), sed(l), 8h(l). 

DIAGNOSTICS 

Ebdt status is if any matches are found, 1 if none, 2 for sjmtax errors or inaccessible files (even if 
matches were foimd). 

BUGS 

Ideally there should be only one grep, but we do not know a single algorithm that spans a wide 

enough range of space-time tradeoffs. 

Lines are limited to BUFSIZ characters; longer lines are truncated. (BUFSIZ is defined in 

/usr/include/stdio.h.) 

Egrep does not recognize ranges, such as [a-z], in character classes. 

Grep finds lines in the input file by searching for a new-line. Thus, if there is no new-line at the 

end of the file, grep will ignore the last line of the file. 

If there is a fine with embedded nulls, grep will only match up to the first null; if it matches, it 

will print the entire line. 

INTERNATIONAL SUPPORT 

grep: 8- and 16-bit data, 8-bit filenames, messages 

egrep: 8-bit data and filenames 

fgrep: 8-bit data and filenames, messages. 
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NAME 

groups - show group memberships 

SYNOPSIS 

groups [ [-p] [-g] [-1] user ] 

DESCRIPTION 

The groups command shows the groups to which you or the optionally specified user belong. If 
invoked with no arguments, groups prints the current access list returned by getgroups{2) . Each 
user belongs to a group specified in the password file /etc/passwd and possibly to other groups 
as specified in the files /etc/group and /etc/logingroup . A user is granted the permissions of 
those groups specified in /etc/passwd and /etc/logingroup at login time. The permissions of 
the groups specified in /etc/group are normally available only with the use of newgrp{l). If a 
user name is specified with no options, groups prints the union of all these groups. The -p, -g, 
and -1 options limit the list which is printed to only those groups specified in /etc/passvs^d, 
/etc/group, and /etc/logingroup, respectively. 

FILES 

/etc/group 

/etc/logingroup 

/etc/passwd 

AUTHOR 

Groups was developed by the University of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

id(l), newgrp(l), getgroups(2), initgroups(3C), group(4). 
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NAME 

head - give first few lines 

SYNOPSIS 

head [ -coimt ] [ file ... ] 

DESCRIPTION 

This filter gives the first count lines of each of the specified files, or of the stEindard input. If 
count is omitted it defaults to 10. 

SEE ALSO 

tail(l). 
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NAME 

help - ask for help 

SYNOPSIS 

help [args] 

DESCRIPTION 

Help finds information to explain a message from a command or explain the use of a command. 
Zero or more argmnents may be supplied. If no arguments are given, help will prompt for one. 

The argimients may be either message numbers (which normally appear in parentheses following 
messages) or command names, of one of the following types: 

type 1 Begins with non-numerics, ends in numerics. The non-numeric prefix is usually 

an abbreviation for the program or set of routines which produced the message 
(e.g., ge6, for message 6 from the get command). 

type 2 Does not contain numerics (as a command, such as get) 

type 3 Is all nmneric (e.g., 212) 

The response of the program will be the explanatory information related to the argument, if there 
is any. 

When all else fails, try "help stuck". 

FILES 

/usr /lib/help directory containing files of message text. 

/usr/lib/help/helploc file containing locations of help files not in /usr /lib/help. 

DIAGNOSTICS 

Use help{l) for explanations. 

BUGS 

Only sees and a very few other commands currently use help. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

hostname - set or print name of current host system 

SYNOPSIS 

hostname [ nameofhost ] 

DESCRIPTION 

The hostname command prints the name of the current host, as given in the uname system call. 
The super-user can set the hostname by giving an argument; this is usually done in the startup 
script /etc/rc. 

AUTHOR 

Hostname was developed by the University of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

imame(l), gethostname(2), sethostname(2), imame(2). 
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NAME 

hp - handle special functions of HP 2640 and 2621-series terminals 

SYNOPSIS 

hp [ -e ] [ -m ] 

DESCRIPTION 

Hp supports special functions of the Hewlett-Packard 2640- and 2621- series of terminals, with the 
primary pmrpose of producing accurate representations of most nroff{l) output. A typical use is: 

nroff -h files ... | hp 

Regardless of the heu'dware options on yoiu terminal, hp tries to do sensible things with underlin- 
ing and reverse line-feeds. If the terminal has the "display enhancements" feature, subscripts and 
superscripts can be indicated in distinct ways. If it has the "mathematical-symbol" feature, 
Greek and other special characters can be displayed. 

The options are as follows: 

-e It is assumed that your terminal has the "display enhancements" featm-e, and so 

maximal use is made of the added display modes. Overstruck characters are 
presented in the Underline mode. Superscripts are shown in Half-bright mode, 
and subscripts in Half-bright, Underlined mode. If this flag is omitted, hp 
assmnes that your terminal Isicks the "display enhancements" feature. In this 
case, all overstruck characters, subscripts, and superscripts are displayed in 
Inverse Video mode, i.e., dark-on-light, rather than the usual light-on-dark. 

-m Requests minimization of output by removal of new-lines. Any contiguous 

sequence of 3 or more new-lines is converted into a sequence of only 2 new-lines; 
i.e., any number of successive blank lines produces only a single blank output 
line. This allows you to retain more actual text on the screen. 
DIAGNOSTICS 

"line too long" if the representation of a line exceeds 1,024 characters. 

The exit codes are for normal termination, and 2 for all errors. 
SEE ALSO 

col(l), greek(l), neqn(l), nrofr(l), tbl(l). 



BUGS 



An "overstriking sequence" is defined as a printing character followed by a backspace followed by 
another printing character. In such sequences, if either printing character is an underscore, the 
other printing character is shown imderlined or in Inverse Video; otherwise, only the first printing 
chareicter is shown (again, imderlined or in Inverse Video). Nothing special is done if a backspace 
is adjacent to an ASCII control character. Sequences of control characters (e.g., reverse line-feeds, 
backspaces) can make text "disappear"; in particular, tables generated by (6/(1) that contain 
vertic£il lines will often be missing the lines of text that contain the "foot" of a vertical line, tmless 
the input to hp is piped through co/(l). 

Although some terminals do provide numerical superscript characters, no attempt is made to 
display them. 
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NANfE 

hpiutil - ALLBASE/HP-UX HPIMAGE database utilities 

SYNOPSIS 

hpiutil 

REMARKS 

The ALLBASE/HP-UX product must be previously installed on the system for hpiutil to function. 

DESCRIPTION 

Hpiutil invokes the HPIMAGE utiUty program for maintaining and reconfiguring an 
ALLBASE/HP-UX HPIMAGE network database. No options are available with this command. 
Hpiutil can be executed by all system users on all database files created by them. 

AUTHOR 

Hpiutil was developed by Hewlett-Packard. 

FILES 

/usr/bin/hpdbdaemon cleanup daemon program file 

/usr/bin/hpimage HPIMAGE progrsun file 

/usr/bin/hpiutil HPIUTIL program file 

/usr/lib/hpicaOOO HPIMAGE message catalog file 

SEE ALSO 

ALLBASE/HP-UX HPIMAGE Reference Manual. 
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NAME 

hyphen - find hyphenated words 

SYNOPSIS 

hyphen [ files ] 

DESCRIPTION 

Hyphen finds all the hyphenated words ending lines in files and prints them on the standard out- 
put. If no argmnents are given, the standard input is used; thus, hyphen may be used as a filter. 

EXAMPLE 

The following will allow the proofi-eading of nroff hyphenation in textfile. 

mm textfile | hyphen 

SEE ALSO 

mm(l), nroff(l). 

BUGS 

Hyphen cannot cope with hyphenated italic (i.e., imderlLned) words; it will often miss them com- 
pletely, or mangle them. 
Hyphen occasionally gets confused, but with no ill effects other than spurious extra output. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 
id 

DESCRIPTION 

Id writes a message on the standard output giving the user and group IDs and the corresponding 
names of the invoking process. If the eflFective and real IDs do not match, both are printed. 

AUTHOR 

Id was developed by the Hewlett-Packard Company and AT&T Bell Laboratories. 

SEE ALSO 

logname(l), getuid(2). 
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NAME 

insertmsg - use findstr(l) output to insert calls to getnisg(3C) 

SYNOPSIS 

insertmsg stringlist 

DESCRIPTION 

Insertmsg examines the file stringlist, which is assTimed to be the output of findstr minus the 
strings which do not need to be localized and have been removed by editing. Insertmsg first 
places the line 

#include <m8gbuf.h> 

at the beginning of each file named in stringlist. Then for each line in stringlist, it smrounds the 
string with an expression of the form 

(*getmsg(nl fd, nl set num, nl msg num, nL_msg_buf, NL__MBUFLN) 

== '\0' ? "saved string" : nl msg_buf) 

which evaluates to the original string if the translation cannot be retrieved. The string buffer and 

other "nl " variables and constants are defined in <msgbuf.h>. Insertmsg places the modified 

source on a file nL—xx.c where the original file name was xx.c. The user must then hand edit the 
file to insert a call 

nl catopen("/*appropriate message catalog*/"); 

and assign the proper value to nl— set— num. 

Insertmsg also places on the standard output a file which can be used as input to gencat. Again, 
hand editing is required to define the £set number to match nl^set—num. Messages will 
automatically be munbered from 1 upward in the order that they appear in stringlist. The same 
niunber will also be placed in the call to getmsg{3C), as the parameter msg— num. 

DIAGNOSTICS 

If insertmsg does not find the opening or closing double quote where it expects it in the strings 
file, it prints "insertmsg exiting : lost in strings file" and dies. If this happens, check the strings 
file to make siu-e that the lines that have been kept there have not been altered. 

SEE ALSO 

findstr(l), gencat(l), getmsg(3C). 

BUGS 

Inserts a pointer to a static area which is overwritten on each call. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 



insf - ] 


nstall special files 


SYNOPSIS 
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f devfile 
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f devfile 


-d IprO [-1 lu] 


insf [- 


f devfile 


-d nun 


insf [- 


f devfile 


-d muxO [-1 lu] 


insf [- 


f devfile 
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DESCRIPTION 

Insf installs special files in the current directory. The -f option specifies devfile, which is a file 
that describes drivers and pseudo-drivers. This file is generated by xixgen(\). If the -f option is 
not given, the file /etc/devices is used. 

If the -d option is not entered, ins/ installs special files for every entry in devfile. The -d option 
specifies that only special files for a particular driver are to be installed. If the -1 option is given, 
special files for only that logical unit will be installed. The file permissions are set by insf. In a 
few cases, the owner or group id is set. 



CN 



The following sections show which special files are created and their permissions for each driver: 



syscon rw- -w- -w- 
systty rw- -w- -w- 
console rw- -w- -w- 



DIAGO 



diagO rw 



DMEM 



dmem rw- rw- rw- 



DISCO 



Special file names for discO use the following format: c<lu>d<unit>s<section>. For each logical 
unit, the following special files are installed: 

dsk/c<lu>dOs<section> 

sections to 11, group sys, block entry, rw- r 

rdsk/c<lu>dOs<section> 

sections to 11, group sys, character entry, rw- r 

ct/c<lu>d<imit>s2 
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units and 1, block entry, rw- rw- rw- 
rct/c<lu>d<miit>s2 

units and 1, character entry, rw- rw- rw- 
diag/dsk/c<lu>d<unit> 

units and 1, character entry, rw 

ECTEST 

ectest rw- rw- rw- 

GPIOO 

For each logical imit, the following special file is installed: 

gpio<lu> rw- rw- rw- 

INSTRO 

For each logical imit, the following special files are installed: 

hpib/<lu>a<addr> 

addrs to 31, rw- rw- rw- 

KTEST 

ktest rw- rw- rw- 

LPRO 

For each logical unit, the following special file is installed: 

lp<lu> owner Ip, group bin, rw 

MM 

The following special files are installed: 

kmem minor 1, group sys, rw- r 

mem minor 0, group sys, rw- r 

null minor 2, rw- rw- rw- 

MUXO 

For each logical unit, the following special files are installed: 

tty<lu>p<port> 

ports to 5, direct connect, rw- -w- -w- 

MUXl 

For each logical unit, the following special file is installed: 

mux<lu> rw 

PTYO 

ptyp<number> nmnber is from to 9, rw- rw- rw- 

PTYl 

ttyp<number> number is from to 9, rw- rw- rw- 

SD 

hd rw- rw- rw- 

SW 

swap group sys, rw- r 

SY 

tty rw- rw- rw- 
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TAPEO/TAPEl 

For each logical unit, the following special files are installed: 

mt/<lu>l 

800 bpi, block entry, rw- rw- rw- 
mt/<lu>m 

1600 bpi, block entry, rw- rw- rw- 
mt/<lu>h 

6250 bpi, block entry, rw- rw- rw- 
nit/<lu>hi 

no rewind, 800 bpi, block entry, rw- rw- rw- 
nit/<lu>mn 

no rewind, 1600 bpi, block entry, rw- rw- rw- 
mt/<lu>hn 

no rewind, 6250 bpi, block entry, rw- rw- rw- 
rmt/<lu>l 

800 bpi, character entry, rw- rw- rw- 
nnt/<lu>m 

1600 bpi, character entry, rw- rw- rw- 
mit/<lu>h 

6250 bpi, character entry, rw- rw- rw- 
nnt/<lu>ln 

no rewind, 800 bpi, character entry, rw- rw- rw- 
rnit/<lu>mn 

no rewind, 1600 bpi, character entry, rw- rw- rw- 
rmt/<lu>hn 

no rewind, 6250 bpi, chfiracter entry, rw- rw- rw- 
diag/nit/<lu> 

character entry, rw 

AUTHOR 

/na/was developed by HP. 

FILES 

/etc/devices 

SEE ALSO 

Issf(l), mksf(l). 
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NAME 

iostat - report I/O statistics 

SYNOPSIS 

iostat [ -t] [ interval [ count ] ] 

DESCRIPTION 

Iostat iteratively reports for each disk the number of seeks per second, kilobytes transfered per 
second, and the milliseconds per average seek. If given a -t argument, it also reports the nmnber 
of characters read from and written to terminals, and the percentage of time the system has spent 
in user mode, in user mode nmning low priority (niced) processes, in system mode, and idling. 

To compute this information, for each disk, seeks and data transfer completions and number of 
words transferred are coimted; for terminals collectively, the number of input and output charac- 
ters are counted. Also, the state of each disk is examined HZ times per second (as found in 
<sys/par£im.h>) and a tally is made if the disk is active. From these numbers and given the 
transfer rates of the devices it is possible to determine average seek times for each device. 

The optional interval argument causes iostat to report once each interval seconds. The first report 
is for the time since a reboot and each subsequent report is for the last interval only. 

The optional count argiunent restricts the number of reports. 

AUTHOR 

Iostat was developed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

FILES 

/dev/kmem 
/hp-ux 

SEE ALSO 

vmstat(l). 
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NAME 

ipcrm - remove a message queue, semaphore set or shared memory id 

SYNOPSIS 

ipcrm [ options ] 

DESCRIPTION 

Ipcrm will remove one or more specified messages, semaphore or shared memory identifiers. The 
identifiers are specified by the following options: 

-q msqid removes the message queue identifier msqid from the system and destroys the mes- 
sage queue and data structure associated with it. 

-m shmid removes the shared memory identifier shmid from the system. The shared memory 
segment and data structure associated with it are destroyed after the last detsich. 

-8 semid removes the semaphore identifier semid from the system and destroys the set of 
semaphores and data structiu"e associated with it. 

-Q msgkey removes the message queue identifier, created with key msgkey, from the system and 
destroys the message queue and data structure associated with it. 

-M shmkey removes the shared memory identifier, created with key shmkey, from the system. 
The shared memory segment and data structure associated with it are destroyed 
after the last detach. 

-S semkey removes the semaphore identifier, created with key semkey, from the system and 
destroys the set of semaphores and data structure associated with it. 

The details of the removes are described in msgctl{2), shmctl{2), and semctl{2). The identifiers 
and keys may be foimd by using ipcs{l). 

SEE ALSO 

ipcs(l), msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), shmctl(2), shmget(2), 
shmop(2). 
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NAME 

ipcs - report inter-process conuntinication facilities status 

SYNOPSIS 

ipcs [ options ] 

DESCRIPTION 

Ipca prints certain information about active inter-process communication facilities. Without 
options, information is printed in short format for message queues, shared memory, and sema- 
phores that are currently active in the system. Otherwise, the information that is displayed is 
controlled by the following options: 

-q Print information about active message queues. 

-m Print information about active shared memory segments. 

-8 Print information about active semaphores. 

If any of the options -q, -m, or -a are specified, information about only those indicated will be 
printed. If none of these three are specified, information about all three will be printed. 

-b Print biggest allowable size information. (Maximum number of bytes in mes- 

sages on queue for message queues, size of segments for shared memory, and 
number of semaphores in each set for semaphores.) See below for meaning of 
coltmms in a listing. 

-c Print creator's login name and group name. See below. 

-o Print information on outstanding usage. (Niunber of messages on queue and 

total niunber of bytes in messages on queue for message queues and nimiber of 
processes attached to shared memory segments.) 

-p Print process niunber information. (Process ID of last process to send a message 

and process ID of last process to receive a message on message queues and pro- 
cess ID of creating process and process ID of last process to attach or detach on 
shared memory segments) See below. 

-t Print time information. (Time of the last control operation that changed the 

access permissions for all fsicilities. Time of last msgsnd and last msgrcv on mes- 
sage queues, last shmat and last shmdt on shared memory, last semop{2) on 
semaphores.) See below. 

-a Use all print options. (This is a shorthand notation for -b, -c, -o, -p, and 

-t.) 
-C corefile Use the file corefile in place of /dev/kmem. 

-N namelist The argument will be taken as the name of an alternate namelist (/hp-ux is the 
default). 

The coliunn headings and the meaning of the columns in an ipcs listing are given below; the 
letters in parentheses indicate the options that cause the corresponding heading to appear; all 
means that the heading always appears. Note that these options only determine what information 
is provided for each facility; they do not determine which facilities will be listed. 

T (all) 

Type of the facility: 

q message queue; 

m shsu-ed memory segment; 

s semaphore. 
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The identifier for the facility entry. 

KEY (all) 

The key used as an argument to msgget, semget, or shmget to create the facility 
entry. (Note: The key of a shared memory segment is changed to 
IPC— PRIVATE when the segment has been removed until all processes 
attached to the segment detach it.) 

MODE (all) 

The facility access modes and flags: The mode consists of 11 characters that are 

interpreted as follows: 

The first two characters are: 

R if a process is waiting on a magrcv; 
S if a process is waiting on a msgsnd; 

D if the associated shared memory segment has been removed. It will 
disappear when the last process attached to the segment detaches 
it; 
C if the associated shared memory segment is to be cleared when the 
first attach is executed; 

- if the corresponding special flag is not set. 

The next 9 characters are interpreted as three sets of three bits each. The first 
set refers to the owner's permissions; the next to permissions of others in the 
user-group of the facility entry; and the last to all others. Within each set, the 
first character indicates permission to read, the second character indicates per- 
mission to write or alter the facility entry, and the last character is currently 
unused. 
The permissions are indicated as follows: 

r if read permission is granted; 

w if write permission is granted; 

a if alter permission is granted; 

- if the indicated permission is not granted. 
OWNER (all) 

The login name of the owner of the facility entry. 
GROUP (all) 

The group name of the group of the owner of the facility entry. 
CREATOR 

(a,c) 

The login name of the creator of the facility entry. 
CGROUP 

(a,c) 

The group name of the group of the creator of the facility entry. 
CBYTES 

(a,o) 

The number of bytes in messages currently outstanding on the associated mes- 
sage queue. 
QNUM (a,o) 

The nvunber of messages currently outstanding on the associated message queue. 
QBYTES 

(a,b) 

The maximum niunber of bytes allowed in messages outstanding on the associ- 
ated message queue. 
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LSPID (a,p) 

The process ED of the last process to send a message to the associated queue. 

LRPID (a,p) 

The process ID of the last process to receive a message from the associated queue. 

STIME (a,t) 

The time the last message was sent to the associated queue. 

RTIME (a,t) 

The time the last message was received from the associated queue. 

CTIME (a,t) 

The time when the associated entry was created or changed. 

NATTCH 

(a,o) 

The niunber of processes attached to the associated shared memory segment. 

SEGSZ (a,b) 

The size of the associated shared memory segment. 

CPID (a,p) 

The process ID of the creator of the shared memory entry. 

LPID (a,p) 

The process ID of the last process to attach or detach the shared memory seg- 
ment. 

ATIME (a,t) 

The time the last attach was completed to the associated shared memory seg- 
ment. 

DTIME (a,t) 

The time the last detach was completed on the associated shsired memory seg- 
ment. 

NSEMS (a,b) 

The number of semaphores in the set associated with the semaphore entry. 

OTIME (a,t) 

The time the last semaphore operation was completed on the set associated with 
the semaphore entry. 
HARDWARE DEPENDENCIES 

Series 500 

The -C corefile option and the -N option are not supported. 
FILES 

/etc/group group names 

/hp-ux system namelist 

/dev/kmem memory 

/etc/passwd user names 

SEE ALSO 

msgop(2), semop(2), shmop(2). 

BUGS 

Things can change while ipcs is running; the pictiu-e it gives is only a close approximation to real- 
ity. 
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NAME 

iquery - ALLBASE/HP-UX HPIMAGE database access interactive tool 

SYNOPSIS 

iquery 

REMARKS 

The ALLBASE/HP-UX product must be previously installed on the system for iquery to function. 

DESCRIPTION 

Iquery invokes the interactive programmer and database administrator tool for accessing an 
ALLBASE/HP-UX HPIMAGE network database. There are no options available with this com- 
mand. Iquery can be executed by all system users. 

FILES 

/usr/bin/hpdbdaemon cleanup daemon program file 

/usr/bin/hpimage HPIMAGE program file 

/usr/bin/iquery IQUERY program file 

/usr/bin/iquerycf IQUERY program file 

/usr/lib/hpicaOOO HPIMAGE message catalog file 

/usr/lib/hpiqcOOO IQUERY message catalog file 

AUTHOR 

Iquery was developed by Hewlett-Packard. 

SEE ALSO 

ALLBASE/HP-UX IQUERY Reference Manual. 
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NAME 

isl - initial system loader 

DESCRIPTION 

Isl implements the operating system independent portion of the bootstrap process. It is loaded 
and executed after self-test and initialization have completed successfully. 

The processor contains special purpose memory for maintaining critical configuration related 
parameters (e.g. Primary Boot, Alternate Boot, and Console Paths). Two forms of memory are 
supported: Stable Storage and Non- Volatile Memory (NVM). 

Typically, when control is transferred to isl, an autoboot sequence takes place. An autoboot 
sequence allows a complete bootstrap operation to occur with no intervention from an operator. 
Isl executes commands from the autoexecute file in a script-like fashion. Autoboot is enabled by a 
flag in Stable Storage. 

Autosearch is a mechanism that automatically locates the boot and console devices. It is 
currently not implemented on the Model 840 but will be will be implemented on future Series 800 
processors. 

During an autoboot sequence, isl displays its revision and the name of any utility it executes. 
However, if autoboot is disabled, after ial displays its revision, it then prompts for input from the 
console device. Acceptable input is any isl command name or the name of any utility available on 
the system. If a non-fatal error occurs or the executed utility retimis, isl again prompts for input. 

Commands 

There are several commands available in isl. The following is a list of them with a short descrip- 
tion. Parameters may be entered on the command line following the command name. They must 
be separated by spaces. Isl prompts for any necessary parameters that are not entered on the 
command line. 



? 
help 

listf 
Is 

autoboot 

autosearch 

primpath 

altpath 

conspath 

Isautofl 
listautofl 

display 

readnvm 



Help ~ Lists commands and available utilities 

Lists available utilities 

Enables or disables the autoboot sequence 
Parameter — on or off 

Enables or disables the autosearch sequence 
Parameter ~ on or off 

Modify the Primary Boot Path 

Parameter ~ Primary Boot Path in decimal 

Modify the Alternate Boot Path 

Parameter - Alternate Boot Path in decimal 

Modify the Console Path 
Parameter ~ Console Path in decimal 

Lists contents of the autoexecute file 

Displays the Primary Boot, Alternate Boot, and Console Paths 

Displays the contents of one word of NVM in hexadecimal 

Parameter — NVM address in decimal or standard hexadecimal notation 

Displays the contents of one word of Stable Storage in hexadecimal 

Parameter — Stable Storage address in decimal or standard hexadecimeil notation 
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DIAGNOSTICS 

Isl displays diagnostic information through error messages written on the console and display 
codes on the hexadecimal LED display. 

For the display codes, CESQx are informative only. CElx and CE2x indicate errors, some of 
which are fatal and cause the system to halt. Other errors merely cause isl to display a message. 
During normal operation, the self-test light is yellow. However, during fatal errors, the self-test 
light is red. 

Non-fatal errors diu*ing an autoboot sequence cause the autoboot sequence to be aborted and ial to 
prompt for input. After non-fatal errors during an interactive ial session, ial merely prompts for 
input. 

Fatal errors cause the system to halt. The problem must be corrected and the system RESET to 
recover. 

CEOO Ial is executing. 

CEOl Ial is autoboo&ng &om the autoexecute file. 

CE02 Cannot find an autoexecute file. Autoboot aborted. 

CEOS No console found, ial can only autoboot. 

CEOS Directory of utilities is too big, ial reads only 2K bytes. 

CEOO Autoexecute file is inconsistent. Autoboot aborted. 

CEX)7 Utility file header inconsistent: SOM values invalid. 

CEOS Autoexecute file input string exceeds 2048 characters. Autoboot aborted. 

CEX)9 Ial command or utility name exceeds 10 characters. 

CEOF Ial has transferred control to the utility. 

CEIO Internal inconsistency: Volume label - FATAL. 

CEll Internal inconsistency: Directory - FATAL. 

CE12 Error reading autoexecute file. 

CE13 Error reading from console - FATAL. 

CE14 Error writing to console - FATAL. 

CE15 Not an ial command or utility. 

CE16 Utility file header inconsistent: Invalid System ID. 

CE17 Error reading utility file header. 

CE18 Utility file header inconsistent: Bad magic niunber. 

CE19 Utility would overlay ial in memory. 

CEIA Utility requires more memory than is configured. 

CEIB Error reading utility into memory. 

CEIC Incorrect checksum: Reading utility into memory. 

CEID Console needed - FATAL. 

CEIE Internal inconsistency: Boot device class - FATAL. 

CE21 Destination memory address of utility is invalid. 

CE22 Utility file header inconsistent: pdc-.cache entry. 
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CE23 Internal inconsistency: iodc entry— init - FATAL. 

CE24 Internal inconsistency: iodc— entry— init - console - FATAL. 

CE25 Internal inconsistency: iodc— entry— init - boot device - FATAL. 

CE26 Utility file header inconsistent: Bad aux_Jd. 

CE27 Bad utility file type. 

SEE ALSO 

boot(lM), hpuxboot(lM), pdc(lM). 
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NAME 

isql - ALLBASE/HP-UX interactive SQL interface 

SYNOPSIS 

isql 

REMARKS 

The ALLBASE/HP-UX product must be previously installed on the system for isql to function. 

DESCRIPTION 

Isql invokes the Interactive SQL interface for defining and accessing an ALLBASE/HP-UX rela- 
tional DataBase Environment (DBEnvironment). There are no options available with this com- 
mand. Isql can be executed by all system users. 

AUTHOR 

Isql was developed by Hewlett-Packard. 

FILES 

/usr/bin/hpdbdaemon cleanup daemon program file 

/usr/lib/hpsqlproc HP SQL program file 

/usr/bin/isql Interactive SQL program file 

/usr/bin/sqlutil SQLUTIL program file 

/usr/lib/hpsqlcat HP SQL message catalog file 

/usr/lib/isqlwel Interactive SQL welcome banner file 

SEE ALSO 

ALLBASE/HP-UX ISQL Reference Manual. 
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NAME 

join - relational database operator 

SYNOPSIS 

join [ options ] filel file2 

DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified by the lines of JUel and 
fileS. If filel is -, the standard input is used. 

Filel and fileS must be sorted in increasing ASCII collating sequence on the fields on which they 
are to be joined, normally the first in each line. 

There is one line in the output for each pair of lines in filel and fileS that have identical join 
fields. The output line normally consists of the common field, then the rest of the line from filel , 
then the rest of the line from file2. 

The default input field separators are blank, tab, or new-line. In this case, multiple separators 
count as one field separator, and leading separators are ignored. The default output field separa- 
tor is a blank. 

Some of the below options use the argument n. This argument should be a 1 or a 2 referring to 
either filel or file2, respectively. The following options are recognized: 

-an In addition to the normal output, produce a line for each impairable line in file n, where n 
is 1 or 2. 

-e s Replace empty output fields by string s. 

-jn m Join on the mth field of file n. If n is missing, use the mth field in each file. Fields are 
numbered starting with 1. 

-o list Each output line comprises the fields specified in list, each element of which has the form 
n.m, where n is a file niunber and m is a field niunber. The conunon field is not printed 
unless specifically requested. 

-tc Use character c as a separator (tab character). Every appearance of c in a line is 
significant. The character c is used as the field separator for both input and output. 

EXAMPLE 

The following command line will join the password file and the group file, matching on the 
numeric group ID, and outputting the login name, the group name and the login directory. It is 
assumed that the files have been sorted in ASCII collating sequence on the group ID fields. 

join -jl 4 -j2 3 -o 1.1 2.1 1.6 -t: /etc/passwd /etc/group 

SEE ALSO 

awk(l), comm(l), sort(l), uniq(l). 

BUGS 

With default field separation, the collating sequence is that of sort -b; with -t, the sequence is 
that of a plain sort. 

The conventions of join, sort, comm, uniq and awk(l) are incongruous. 

Filenames that are nmneric may cause conflict when the -o option is used right before listing 
filenames. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

kennit - KERMIT-protocol file transfer program 

SYNOPSIS 

kermit c [Ibe line baud escapechar] 
kermit r [diflb line baud] 
kermit s [diflb line baud] file... 

MARKETING MODEL 

HP+ File Migration Package 

TECHNICAL MODEL 

Importability 

DESCRIPTION 

Kermit is a file transfer program in common use on MS-DOS systems. It can also be used to 
tranfer files between two HP-UX systems when used in conjunction with c«(l). 

Options 

c connect 

r receive files 

s send files 

b baud rate 

d debug 

e escape char 

f no filename conversion 

i image mode 

1 tty line 

For remote kermit, the format is either 

kermit r 
to receive files, or 

kermit s file ... 
to send files. 

EXAMPLES 

A typical kermit file transfer in conjunction with cu(l) follows: 

$ cu -IculbO -qm dir 

Connected 

%ls 

% kermit r 

~&kermit sib /dev/culbO 9600 filel file2 

Kermit: Sending filel as FILEl 

Kermit: Sending file2 as FILE2 

Kermit: done. 

& 

%ls 

filel file2 

%~. 

Disconnected 
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AUTHOR 

Kermit is in the public domain. 

SEE ALSO 

umodem(l), cu(l), uucp(l). 
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NAME 

kiii - terminate a process 

SYNOPSIS 

kill [ ^igno ] pro ... 

DESCRIPTION 

Kill sends signal 15 (terminate) to the specified processes. This will normally kill processes that 
do not catch or ignore the signal. The process nmnber of each asynchronous process started with 
& is reported by the Shell (imless more than one process is started in a pipeline, in which case the 
nmnber of the last process in the pipeline is reported). Process nmnbers can also be fomid by 
using ps(l). 

The details of the kill are described in ^7/(2). For example, if process number is specified, all 
processes in the process group are signaled. 

The killed process must belong to the current user unless he is the super-user. 

If a signal nmnber preceded by - is given as first argument, that signal is sent instead of ter- 
minate (see signal{2)). In particular "kill -9 . . ." is a sin* kill. 

SEE ALSO 

P8(l), 8h(l), km(2), signal(2). 

BUGS 

If a process becomes hung during some operation (such as I/O) so that it is never scheduled, that 
process will not die until it is allowed to run. Thus, such a process may never go away after the 
kill. 
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NAME 

last, lastb - indicate last logins of users and teletypes 

SYNOPSIS 

last [ -N ] ( name ... ] ( tty ... ] 
lastb [ -N ] [ name ... ] [ tty ... ] 

DESCRIPTION 

Last will look back in the wtmp file which records all logins and logouts for information about a 
user, a teletype or any group of users and teletypes. Arguments specify names of users or tele- 
types of interest. Names of teletypes may be given fully or abbreviated. For example 'last 0' is 
the same as 'last ttyO'. If multiple arguments are given, the information which applies to any of 
the arguments is printed. For example 'last root console' would list all of "root's" sessions as well 
as all sessions on the console terminal. Last will print the sessions of the specified users and tele- 
types, most recent first, indicating the times at which the session began, the duration of the ses- 
sion, and the teletype which the session took place on. If the session is still continuing or was cut 
short by a reboot, last so indicates. 

The pseudo-user reboot logs in at reboots of the system, thus 

last reboot 

will give an indication of mean time between reboot. 

Last with no argmnents prints a record of all logins and logouts, in reverse order. The -N option 
limits the report to N lines. 

If last is interrupted, it indicates how far the search has progressed in tvtmp. If interrupted with a 
quit signal (generated by a control-\) last indicates how far the search has progressed so far, and 
the search continues. 

Lastb will look back in the btmp database to display bad login information. 

AUTHOR 

Last was developed by the University of California, Berkeley. 

FILES 

/etc/btmp bad login data base 

/etc/wtmp login data base 

SEE ALSO 

login(l), utmp(4). 
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NAME 

Id - link editor 

SYNOPSIS 

Id [ (option] ... [file] ... ] ... 

DESCRIPTION 

Ld takes one or more object files as input and combines them to produce a single (usually execut- 
able) file. In doing so it resolves references to external symbols, assigns final addresses to pro- 
cedures and variables, revises code and data to reflect new addresses (a process called relocation), 
and updates symbolic debug information (when it is present in the file). By default, Id processes 
one or more object files to produce an executable file that can be run by the HP-UX loader 
exec{2). Alternatively, the linker can generate a relocatable file -one suitable for further process- 
ing by Id (see -r below). Ld will not generate an output file if any errors occiu- diiring its opera- 
tion. 

Ld recognizes two kinds of input files: object files created by the compilers or assembler (also 
known as '.o' files) and archives of such object files (called libraries). A library contains an index 
of all the externally- visible symbols from its component object files. (The archiver command ar(l) 
creates and maintains this index.) Ld uses this table to resolve references to external symbols. 

Ld processes files in the same order as they appear on the command line. It includes code and 
data from a library element if, and only if, that object module provides a definition for a currently 
unresolved reference within the user's program. It is common practice to list libraries following 
the names of all simple object files on the command line. 

Options 

Ld recognizes the following options: 

-d Forces definition of "common" storage, i.e., assign addresses and sizes, even for 

-r output. 

-€ epaym Set the default entry point address for the output file to be that of the symbol 

epsym. (This option only applies to executable files.) 

-f fill Set the default fill pattern for "holes" within an output file as well as initialized 

bas sections. The argument fill is a two-byte constant. 

-h symbol Prior to writing the symbol table to the output file, mark this name as "local" so 

that it is no longer externally visible. This ensures that this particular entry will 
not clash with a definition in another file during future processing by Id. (Of 
course, this only makes sense with the -r option.) 

-la: Search a library libx.a, where x is up to nine characters. A library is searched 

when its name is encountered, so the placement of a -1 is significant. By default, 
libraries are located in /lib and /usr/lib. 

-m Produce a load map on the standard output. 

-n Generate an (executable) output file with code to be shared by all users. Com- 

pare with -N. 

-o outfile Produce an output object file by the name outfile. (The default name is a.out.) 

-q Generate an (executable) output file that is demand-loadable. Compare with 

-Q 

-r Retain relocation information in the output file for subsequent re-linking. Ld will 

not report imdefined symbols. 
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-8 Strip the output file so that it does not contain symbol table, relocation, and 

debug support information. This may impair or prevent the use of a symbolic 
debugger on the resulting program. This option is incompatible with -r. (The 
strip{l) command also removes this information.) 

-t Print a trace (to standard output) of each input file as Id processes it. 

-u symname Enter symname as an imdefined symbol in the symbol table. The resulting 
unresolved reference is useful for linking a program entirely from object files in a 
library. 

-V Display verbose messages diiring linking. This option may have little or no 

effect. It is useful for obtaining more information about an error that occius 
while linking. 

-X Partially strip the output file, i.e., leave out local symbols. The intention is to 

reduce the size of the output file without impairing the effectiveness of object file 
utilities. Note: use of -x may impact the use of a debugger. 

—z Arrange for run-time dereferencing of null pointers to produce a SIGSEGV sig- 

nal. (This is the complement of the -Z option.) 

-L dir Change the algorithm of searching for libx.a to look in dir before looking in the 

default places. This option is effective only if it precedes the -1 option on the 
command line. 

-N Generate an (executable) output file that is not shareable. This option also 

causes the data to be placed immediately following the text, and the text to be 
made writable. 

— Q Generate an (executable) output file that is not demand-loadable. (This is the 

complement of the -q option.) 

-R offset Set the origin (in hexadecimal) for the text (i.e. code) segment. 

-V num Use num as a decimal version stamp identifying the a.out file that is produced. 

(This is not the same as the version information reported by the SCCS what{l) 
command.) 

-X num Define the initial size for the linker's global symbol table. Thus you can reduce 

link time for very large programs, i.e., those with very many external symbols. 

-Z Arrange for run-time dereferencing of null pointers to be permitted. (See in 

cc(l) the discussions of -Z and pointers.) (This is the complement of the -z 
option.) 

Defaults 

Unless otherwise directed. Id names its output a.out. The -o option overrides this. Executable 
output files are marked as shareable. 

EXAMPLES 

The following command line links part of a C program for later processing by Id. It also specifies 
a version number of 2 for the output file. (Note the '.o' suffix for the output object file. This is 
an HP-UX convention for indicating a linkable object file.) 

Id -V 2 -r filel.o file2.o -o prog.o 

The next example links a simple FORTRAN program for use with the cdb{l) symbolic debugger. 
The output file name will be a.out since there is no -o option in the command line. (Note: the 
particular options shown here are for a Series 200 and 300.) 
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Id -e start /lib/frtO.o ftn.o -1177 -1F77 -Im -Ic /usr/lib/end.o 
Finally, this command will link a Pascal program on a Series 200 and 300. 
Id -e start /lib/prtO.o main.o -Ipccat -Ipc -Im -Ic 

HARDWARE DEPENDENCIES 

Series 200, 300 

The default entry point is taken to be text location 0x0 (which is also the default origin of 
the program text). This corresponds to the first procedure in the first input file that the 
linker reads. Use the -e option to select a diflferent entry point. 

The version number specified with the -V option must be in the range - 32,767. 

The Series 200 and 300 linker does not support the following options: -f, -m, -v, -z, 
-L, and -Z. 

Series 500 

The linker searches for —main (written as main in C) as the main entry point for a user 
program. Use the -e option to select a different entry point. 

The special names etext and edata are not supported. 

The linker marks output files with the following memory management attributes by 
default: virtual code, virtual data (both D-data and I-data), and paged I-data. Execut- 
able output files are not shareable if they contain symbolic debug information. 

The -N option does not cause the data to be placed immediately after the text because 
each is always kept in a separate segment. 

The -t option displays file names twice, once for each pass over the input. 

These options are specific to the Series 500 linker: 

-A Put D-data and I-data in separate segments. 

-M maxsize Merge code segments. The integer argument specifies a target upper 
bound on the size of output code segments. (The actual size may vary 
from this.) 

-T Put D-data and I-data into the same segment. 

The Series 500 linker does not support the following options: -f, -m, -x, -L, and -R. 

Unless the user specifies a -A or a -T option, the linker puts all data in a single segment 
(GDS) when the total data size is less than or equal to 16,384 bytes. 

Series 800 

The linker searches for the sjrmbol $START$ as the program entry point. This symbol 
is defined in the file /lib/crtO.o, which should be the first file loaded for all programs, 
regardless of source language. 

Nonsharable, executable files generated with the -N option cannot be executed via 
exec{2). Typically, -N is used when rebuilding the kernel. 

The following options are specific to the Series 800 linker: 

-y symname Indicate each file in which symname appears. Many such options may 
be given to trace many symbols. 

-Cn Set the maximum parameter checking level to n. The default maximum 

is 3. See the language manuals for the meanings of the parameter 
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checking level. 

-D offset Set the origin (in hexadecimal) for the data space. The default value for 

offset is 0x40000000. 

-G Strip all unloadable data from the output file. This option is typically 

used to strip debug information. 

-S' Generate an Initial Program Loader (IPL) auxihary header for the out- 

put file, instead of the default HP-UX auxiliary header. 

-T Save the load data in a file instead of memory during linking. This 

option reduces the virtual memory requirements of the linker. 

The Series 800 linker does not support the following options: -f, -h, -x, -V, and -X. 



FILES 



/hb/crtO.o run-time start-up for C 

/lib/frtO.o run-time start-up for FORTRAN 

/lib/prtO.o run-time start-up for Pascal 

/usr /lib/end. o for use with cdb/fdb/pdb{l) 

/lib/libxa libraries 

/usr/lib/libxa libreiries 

a.out output file 

SEE ALSO 

ar(l), cc(l), cdb(l), fc(l), nm(l), pc(l), strip(l), exec(2), end(3C), a.out(4), ar(4). 

DIAGNOSTICS 

Ld returns a zero when the link is successful. A non-zero return code indicates that an error 
occurred. 

WARNINGS 

Ld recognizes several names as having special meanings. The names end, edata, and etext (pre- 
ceded by an vmderscore in some implementations) are reserved. (See end(3C) for details.) Users 
must not write alternative (externally-visible) definitions for these names. 

Through its options, the link editor gives users great flexibility; however, those who invoke the 
linker directly must assiune some added responsibilities. Input options should ensm-e the follow- 
ing properties for programs: 

• When the link editor is called through cc(l), a start-up routine is linked with the user's pro- 
gram. This routine calls exit{2) after execution of the main program. If users call Id directly, 
they must ensure that the program always calls ex%t{) rather than falling through the end of the 
entry routme. 

• When linking for use with the symbolic debugger cdb, the user must ensure that the program 
contains a routine called main. Also, the user must link in the file /usr/lib/end.o as the last 
file named on the command line. 

There is no guarantee that the linker will pick up files from libraries and include them in the final 
program in the same relative order that they occur within the library. 



Hewlett-Packard Company - 4 - Version B.l, October 1986 



LEAVE(l) HP-UX LEAVE(l) 



NAME 

leave - remind you when you have to leave 

SYNOPSIS 

leave [ hhmTn ] 

DESCRIPTION 

Leave waits until the specified time, then reminds you that you have to leave. You are reminded 
5 minutes and 1 minute before the actual time, at the time, and every minute thereafter. When 
you log off, leave exits just before it would have printed the next message. 

The time of day is in the form hhmm where hh is a time in hours (on a 12 or 24 hour clock). All 
times are converted to a 12 hour clock, and assumed to be in the next 12 hoiu^. 

If no argument is given, leave prompts with "When do you have to leave?". A reply of newline 
causes leave to exit, otherwise the reply is assumed to be a time. This form is suitable for inclu- 
sion in a .login or .profile. 

Leave ignores interrupts, quits, and terminates. To get rid of it you should either log off or use 
"kill -9" giving its process id. 

AUTHOR 

Leave was developed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

calendar(l). 
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NAME 

lex - generate programs for lexical analysis of text 

SYNOPSIS 

lex [ -rctvn ] [ -X<8econdary><n> ... ] [ file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analysis of text. 

The input files contain strings and expressions to be searched for, and C text to be executed when 
strings are found. Multiple files are treated as a single file. If no files are specified, the standard 
input is used. 

A file lex.yy.c is generated which, when loaded with the library, copies the input to the output 
except when a string specified in the file is found; then the corresponding program text is exe- 
cuted. The actual string matched is left in yytext, an external character array. Matching is done 
in order of the strings in the file. The strings may contain square brackets to indicate character 
classes, as in [abx-z] to indicate a, b, x, y, and z; and the operators *, +, and ? mean respec- 
tively any non-negative number of, any positive mmiber of, and either zero or one occurrences of, 
the previous character or character class. The character . is the class of all ASCII characters 
except new-line. Parentheses for grouping and vertical bar for alternation are also supported. 
The notation r{d,e} in a rule indicates between d and c instances of regular expression r. It has 
higher precedence than I , but lower than *, ?, +, and concatenation. The character * at the 
beginning of an expression permits a successful match only immediately after a new-line, and the 
character $ at the end of an expression requires a trailing new-line. The character / in an expres- 
sion indicates trailing context; only the part of the expression up to the slash is returned in yytext, 
but the remainder of the expression must follow in the input stream. An operator character may 
be used as an ordinary symbol if it is within " symbols or preceded by \. Thus [a-zA-Z]-J- 
matches a string of letters. 

Three subroutines defined as macros are expected: input() to read a character; unput(c) to 
replace a character read; and output (c) to place an output character. They are defined in terms 
of the standard streams, but you can override them. The program generated is named yylex(), 
and the library contains a niain() which calls it. The action REJECT on the right side of the rule 
causes this match to be rejected and the next suitable match executed; the function yyinore() 
acciunulates additional characters into the same yytext; and the function yyle88(p) pushes back 
the portion of the string matched beginning at p, which should be between yytext and 
yytext+yyleng. The macros input and output use files yyin and yyout to read from and write to, 
defaulted to stdin and stdout, respectively. 

Any line begiiming with a blank is assumed to contain only C text and is copied; if it precedes 
%% it is copied into the external definition area of the lex.yy.c file. All rules should follow a 
%%, as in j/occ(l). Lines preceding %% which begin with a non-blank character define the 
string on the left to be the remainder of the line; it can be called out later by surrounding it with 
{ }. Note that curly brackets do not imply parentheses; only string substitution is done. 

The fiags, which must appear before any files, are as follows: 

— r indicates ratfor{i) actions; 

-c indicates C actions - this is the default; 

-t causes the lex.yy.c program to be written instead to the standard output; 

-V provides a one-line smnmary of statistics for the machine generated; 

-n suppresses printing of the - smnmary. 

The —K<secondary><n> option allows the sizes of certain internal lex tables to be reset. Secon- 
dary is one of the letters from the set{dD8Sac} and specifies the table; n is the new size. 
Tables whose size can be changed by using secondary letters are: 
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d table of definitions; default = 200. 

D table of characters in definition strings; default = 5000. 

8 table of start conditions; default = 50. 

S table of characters in start condition names; default = 500. 

c array table for storing character classes; default = 1000. 

a right context/action array table; default = 100. 

If an array overflows, lex issues a fatal error message including a suggestion of which table to 
reset. For example: 

Definitions too long, try -XD option 

Certain table sizes for the resulting finite state machine can be set in the definitions section: 

%p n number of positions is n (default is 2500); 

%n n nmnber of states is n (default is 500); 

%e n number of parse tree nodes is n (default is 1000); 

%a n number of transitions is n (default is 2000). 

%k n number of packed character classes is n (default is 1000); 

%o n size of output array is n (default is 3000); 

The use of one or more of the preceding table options automatically implies -v, imless -n is 
specified. 

Ebctemal names generated by lex all begin with the prefix yy or YY. 

EXANfPLE 

D [0-9] 

%% 

if printfCiF statement\n"); 

(a-z]+ printfCtag, value %s\n'',3rytext); 

0{D}+ printf( "octal number %8\n'',yytext); 

{D}+ printf( "decimal niunber %s\n",yytext); 

"++" printf("imary op\n"); 

"+" printf( "binary op\n"); 

"/*" { loop: 

while (input() != /*/); 

switch (input()) 

{ 

case f/f: break; 
case /*/: imput(/*/); 
default: go to loop; 
} 
} 
SEE ALSO 

yacc(l), malloc(3X). 

LEX - Lexical Analyzer Generator, in HP-UX: Selected Articles. 

BUGS 

The -r option is not yet fully operational. 

The token buffer in the program built by lex is of fixed length, 
yytext[YYLMAX] 
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where YYLMAX is defined to be 200 characters. Overflow of this array is not detected in the 
yy/ez.c program. 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

lifcp — copy to or from LIF files 

SYNOPSIS 

lifcp [-Txxx] [-Lxxx] [-vxxx] [-b] [-ixxx] [-r] [-t] filel file2 

lifcp [-Txxx] [-Lxxx] [-vxxx] [-b] [-bcxx] [-r] [-t] filel [file2 ...] directory 

DESCRIPTION 

Lifcp copies a LIF file to an HP-UX file, an HP-UX file to a LIF file, or a LIF file to another LIF 
file. It also copies a list of (HP-UX/LIF) files to a (LIF/HP-UX) directory. The last name on the 
argument list is the destination file or directory. 

Options may appear singly or be combined in any order before the file names. The space between 
option and argument is optional. 

-Txxx Used only when copying files to a LIF volume. This option will force the file type 

of the LIF directory entry to be set to the argument given, which may be 
decimal, octal or hex in standard "C" notation. 

-Lxxx Used only when copying files to a LIF volmne. This option will set the "last 

volume flag" to xxx (0 or 1). The default "last volume flag" is one. 

-vxxx Used only when copying files to a LIF volume. This option will set the "volume 

number" to xxx. The default "volume number" is one. 

-b This option will force a BINARY mode of copying regardless of the file type. 

When copying in BINARY mode from HP-UX to LIF the default file type is 
BINARY (-2). (For details on available modes of copying refer to /i/(4)). This 
option is a no-op when copying firom LIF to LIF. 

-ixxx Used only when copying files to a LIF volume. This option sets the "implemen- 

tation" field of the LIF directory entry to the argument given, which may be 
decimal, octal or hex in standard "C" notation. The "implementation" field can 
only be set for file types -2001 to -100000 (octal). The "implementation" field is 
set to zero for all interchange file types and for file types -2 to -200 (octal). 

-r This option will force a RAW mode of copying regardless of the file type. When 

copying in RAW mode from HP-UX to LIF the default file type is BIN(-23951). 
-T option will override the default file tjrpe. (various modes of copying are 
explained in /j/(4).) This option is a no-op in case of LIF to LIF copying. 

-t will cause the HP-UX file names to be translated to a name acceptable by a LIF 

utility. That is, all the lower-case letters will be up-shifted and all other charac- 
ters except numeric will be changed to an underscore (_). If the HP-UX file 
name starts with a non-letter, the file name will be preceded by the capital letter 
(X). Note that if there are two files named colon (:) and semicolon (;), both of 

them will be translated to X File names will be truncated to a maximum of 10 

characters. When copying a LIF file to (HP-UX/LIF) file -t is a no-op. Omitting 
-t will cause error to be generated if an improper name is used. 

The default copying modes when copying from LIF to HP-UX are summarized in the following 
table: 

file type default copying mode 

ASCII ASCII 

BINARY BINARY 

BIN RAW 

other RAW 
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When copying from HP-UX to LIF, the default copying mode is ASCII and an ASCII file is 
created. 

When copying from LIF to LIF, if no options are specified then eill the LIF directory fields and 
content of the file are duplicated from source to destination. 

A LIF file name is recognized by the embedded colon (:) delimiter (see /»/(4) for LIF file naming 
conventions). A LIF directory is recognized by a trailing colon. If an HP-UX file name contain- 
ing a colon is used, the colon must be escaped with two backslash characters (\\) (the shell 
removes one of them). 

The file name '-' (dash) will be interpreted to mean standard input or standard output, depending 
on its position in the argument list. This is particularly useful if the data requires non-standard 
translation. When copying from standard input, if no other name can be found, the name 
"STDIN" is used. 

The LIF file naming conventions are known only by the LIF utilities. Since file name expansion is 
done by the shell, this mechanism cannot be used for expansion of LIF file names. 

Note that the media should not be mounted while using lifcp. 

HARDWARE DEPENDENCIES 

Series 500: 

You must use a character special file to access the media. 

Series 800: 

The following option is also supported: 

-Knnn forces each file copied in to begin on a nnn * 1024 byte boimdary from 

the beginning of the volume. This is useful when files are used for Series 
800 boot media. This option has no effect when copying from a LIF 
volume. 

EXAMPLES 

lifcp abc lifvohCDE 

copy HP-UX file abc to LIF file CDE on LIF volume lifvol which is actually an HP-UX file 
initialized to be a LIF volume. 

lifcp -t * ../lifvol: 

will copy all the HP-UX files in the current directory to the LIF volume lifvol which is 
present in the parent directory. File names are translated to appropriate LIF file names. 

lifcp -r -T -5555 -t *.o lifvol: 

will copy all the HP-UX object files in the current directory to the LIF volmne lifvol. Copy- 
ing mode is RAW and LIF file types are set to -5555. 

lifcp -b *.o lifvol: 

All the object files in the current directory are copied to the LIF volume lifvol. Copying 
mode is BINARY and LIF BINARY files are created. 

lifcp -r -t * /lifvol: 

All the files in the current directory are copied to the LIF volume lifvol in root directory. 
Copying mode is RAW and LIF file types are set to BIN. 

lifcp abc\\: lifvohCDE 

copy file abc: to LIF file CDE in lifvol. 

lifcp -t abc def lifvol: 

copy files abc and def to lif files ABC and DEF within lifvol. 

lifcp lifvohABC . 

copy LIF file ABC within lifvol to file ABC within current directory. 
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lifcp - /dev/d8k/l82:A_FILE 

copy standard input to LIF file A FILE on LIF volume /dev/dsk/ls2. 

lifcp lifvohABC /dev/d8k/l82:CDE 

copy LIF file ABC in lifvol to LIF file CDE on /dev/dsk/ls2. 

pr abc I lifcp - lifvohABC 

copy the output of pr to the LIF file ABC. 

pr abc I lifcp - lifvol: 

copy the output of pr to the LIF volume lifvol. LIF file STDIN is crated since no files 
names are specified. 

lifcp lifvohABC - 

copy LIF file ABC in lifvol to standard out. 

lifcp * ../lifvol: 

copy all files within current directory to LIF files of the same name on LIF volimie lifvol 
(may cause errors if file names in the current directory do not obey LIF naming conven- 
tions!). 

AUTHOR 

Lifcp was developed by the Hewlett-Packard Company. 

SEE ALSO 

lifinit(l), lifls(l), lifrename(l), lifrm(l), lif{4). 

DIAGNOSTICS 

Lifcp returns exit code if the file is copied successfully. Otherwise it prints a diagnostic and 
returns non-zero. 
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NAME 

lifinit - write LIF volume header on file 

SYNOPSIS 

liflnit [-vnnn] [-dniin] [-n string] file 

DESCRIPTION 

Lifinit writes a LIF volume header on a volume or file. Options may appear in any order. Their 
meanings are: 

-vnnn Sets the volume size to nnn bytes. If nnn is not a multiple of 256, it will be roimded 

down to the next such multiple. 

-dnnn Sets the directory size to nnn file entries. If nnn is not a multiple of 8, it will be 

roimded up to next such multiple. 

-n string sets the volume name to be string. If the -n option is not specified, the volume name 
is set to the last component of the path name specified by file. A legal LIF volume 
name is 6 characters long and is limited to upper case letters (A-Z), digits (0-9) and 
the imderscore character (_). The first character (if any) must be a letter. The util- 
ity will automatically perform translation to create legal LIF volume names. There- 
fore, all lower-case letters are up-shifted and all other characters except numeric and 
imderscore will be replaced with capital letter (X). If the volume name does not start 
with a letter, the volume name will be preceded by the capital letter (X). The 
volume name will also be right padded with blanks or truncated as needed to be 6 
characters long. If -n is used with no string, the default volume name is set to 6 
blanks. 

If file does not exist, a regular HP-UX disk file is created and initialized. 

The default values for volume size are 256K bytes for regular files, and the actual capacity of the 
device for device files. 

The default directory size is a function of the volume size. A percentage of the volume size is allo- 
cated to the volume directory as follows: 

VOLUME SIZE DIRECTORY SIZE 

< 2MB "1.3% 

> 2MB ~0.5% 

Each directory entry occupies 32 bytes of storage. The actual directory space is subject to the 
rounding rules stated above. 

Note that you should not mount the special file before using lifinit. 

HARDWARE DEPENDENCIES 

Series 200, Series 300 

If your media has never been initialized, it must be initieilized using mediainit{l) before 
lifinit can be used. (Refer to the System Administrator Manual for details concerning 
mediainit.) 

Series 500 

You must use a charsicter special file to access the media. 

If your media has never been initialized, it must be initialized using sdfinit{lM) before 
lifinit can be used. 

Series 800: 
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The following options are also supported: 

-snnn set the initial system load (ISL) start address to nnn in the volume 

label. This is useful when building boot media for Series 800 systems. 

-Inrin specifies the length in bytes of the ISL code in the LIF volume. 

-ennn set the ISL blocksize to nnn bytes. 

-Knnn forces the directory start location to be the nearest multiple of imn * 

1024 bytes from the beginning of the volume. This is necessary for boot- 
ing Series 800 systems oflF of LIF media. 

EXAMPLES 

lifinit -V500000 -dlO x 
lifinit /dev/rdsk/l82 

AUTHOR 

Lifinit was developed by the Hewlett-Packard Company. 

SEE ALSO 

lifcp(l), lifls(l), lifrename(l), lifrm(l), sdfinit(lM), lif(4). 

DIAGNOSTICS 

Lifinit returns exit code if the volmne is initialized successfully. Otherwise it prints a diagnostic 
and returns non-zero. 

WARNING 

Do not terminate lifinit once it has started executing. Otherwise, your media could become cor- 
rupted. 
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NAME 

lifls - list contents of a LIF directory 

SYNOPSIS 

lifts [ option ] name 

DESCRIPTION 

Lifls lists the contents of a LIF directory on STDOUT. The default output format calls for the 
file names to be listed in multiple coliunns (as is done by ls{l), except unsorted) if STDOUT is a 
character special file. If STDOUT is not a teletype, the output format is one file name per line. 
Name is a path name to an HP-UX file containing a LIF volume and optional file name. If name 
is a volume name, the entire voliune is listed. If name is of the form volume:file, then only the file 
is listed. The following options are available and only one option should be specified at any one 
time: 

-1 List in long format, giving voliune name, volume size, directory start, directory size, file 

type, file size, file start, "implementation" field (in hex), date created, last volume and 
volume number. 

-C Force multiple colmnn output format regardless of STDOUT type. 

-L Will return the content of the "last volimie flag" in decimal. 

-i Will return the content of the "implementation" field in hex. 

-V Will return the content of the "volume number" in decimal. 

Note that you should not mount the special file before using lifls. 

HARDWARE DEPENDENCIES 

Series 500: 

You must use a character special file to access the media. 

EXAMPLES 

lifls -1 ../TEST/header 
lifls -C /dev/rdsk/l82 

AUTHOR 

Lifls was developed by the Hewlett-Packard Company. 

SEE ALSO 

lifcp(l), lifinit(l). lifrename(l), lifrm(l), lif(4). 

DIAGNOSTICS 

Lifl^ returns exit code if the directory was listed successfully. Otherwise it prints a diagnostic 
and returns non-zero. 
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NAME 

lifrename - rename LIF files 

SYNOPSIS 

lifrename oldfile newfile 

DESCRIPTION 

Oldfile is a full LIF file specifier (see lif{4) for details) for the file to be renamed (e.g. 
liflBile:A_FILE). Newfile is new name to be given to the file (only the file name portion). This 
operation does not include copy or delete. Old file names must match the name of the file to be 
renamed, even if that file name is not a legal LIF name. 

Note that you should not moimt the special file before using lifrename. 

HARDWARE DEPENDENCIES 

Series 500: 

You must use a character special file to access the media. 

EXAMPLES 

lifrename lifflle:A_FILE B_FILE 
lifrename /dev/d8k/l82:ABC CDE 

AUTHOR 

Lifrename was developed by the Hewlett-Packard Company. 

SEE ALSO 

lifcp(l), lifinit(l), lifls(l), lifrm(l), lif(4). 

DIAGNOSTICS 

Lifrename returns exit code if the file name is changed successfully. Otherwise it prints a diag- 
nostic and returns non-zero. 
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NAME 

lifrm - remove a LIF file 

SYNOPSIS 

lifrm filel ... filen 

DESCRIPTION 

Lifrm removes one or more entries from a LIF volmne. File name specifiers sire as described in 

urn- 

Note that you should not mount the special file before using lijrm. 

HARDWARE DEPENDENCIES 

Series 500: 

You must use a character special file to access the media. 

EXAMPLES 

lifrm liffile:MAN 

lifrm /dev/rd8k/l82.0:F 

AUTHOR 

Lifrm was developed by the Hewlett-Packard Company. 

SEE ALSO 

lifcp(l), lifinit(l), lifls(l), lifrename(l), lif(4). 

DIAGNOSTICS 

Lifrm returns exit code if the file is removed successfully. Otherwise it prints a diagnostic and 
returns non-zero. 
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NAME 

line - read one line from user input 

SYNOPSIS 
line 

DESCRIPTION 

Line copies one line (up to a new-line) from the standard input and writes it on the standard out- 
put. It returns an exit code of 1 on EOF and always prints at least a new-line. It is often used 
within shell files to read from the user's terminal. 

SEE ALSO 

sh(l), read(2). 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

linkinfo - object file link information utility 

SYNOPSIS 

linkinfo [ [optionl ... [file] ... ] ... 

Remarlcs: 

Linkinfo is implemented on the Series 500 only. 

DESCRIPTION 

Linkinfo examines the object files that are part of a program and prints statistics about sizes of 
the various data areas and symbol table information. Linkinfo searches libraries and examines 
object files in the same fashion as the link editor Id. Thus your command line should reflect the 
same ordering of object files and libraries as it does for the corresponding link. 

Linkinfo is intended for developers of large FORTRAN applications who want information about 
data sizes in order to time their application for the Series 500 architecture. It prints a file-by-file 
summary of sizes for code segments and for the D-data and I-data areas (both initialized and 
iminitialized). There are options for including information about COMMON blocks, linker- 
generated pointers, and linker symbol entries (again, file-by-file). There is also provision for gen- 
erating a crude cross-reference of COMMON block usage by file. 

Linkinfo options may occur anywhere on the conunand line after the command name itself. Some 
options take a modifier inunediately following the option letter (e.g. ... -e entryname). The space 
between the option and the modifier is optional. 

This utility recognizes the following options. Note that a colon indicates that the option takes an 
argument; the colon itself is not a hteral, and must not appear when specifying arguments. 

-c requests the name and size of COMMON blocks in the input files. 

-e: names an alternate entry jwint for the user program, other than main. The loader calls 

this alternate entry point at run-time. 

-1: abbreviates a library name. Linkinfo searches a default set of directories to locate the 

desired library. These directories are /lib and /usr/lib. 

The utility searches these directories in the above order, looking for the library libzzx.a, 
where xxx is a string of one or more ASCII characters specified as the modifier for the -1 
option. Since linkinfo searches a library immediately upon encoimtering the library's 
name on the command line, the placement of the -I option is significant. A -1 with no 
modifier is the same as -Ic, which causes lirUnnfo to search the standard C library. 

-p requests size information on linker-generated pointers. 

-8 forces inclusion of symbol table size information for each input file. 

-u: specifies a name to enter in the symbol table as imdefined. This entry appears as an 
imresolved reference to the command name. You can use it to force loading object infor- 
mation solely from a library. 

-X produces a cross-referenced listing of COMMON block usage. This information is saved in 

the file xref.out. 
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SEE ALSO 

ld(l), getopt(l). 

DIAGNOSTICS 

Linkinfo returns the following exit codes: 

- no errors 

1 - abort (killed by signal) 

2 - error during link 
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NAME 

lint - a C program checker/verifier 

SYNOPSIS 

lint [ options ] file ... 

DESCRIPTION 

Lint attempts to detect featm^s of the C program files which are likely to be bugs, non-portable, 
or wasteful. It also checks type usage more strictly than the compilers. Among the things that 
are currently detected are unreachable statements, loops not entered at the top, automatic vari- 
ables declared and not used, and logical expressions whose value is constant. Moreover, the usage 
of functions is checked to find functions that retimi values in some places and not in others, func- 
tions called with varying niunbers or types of arguments, and functions whose values are not used 
or whose values are used but none returned. 

Arguments whose names end with .c are taken to be C soiurce files. Arguments whose names end 
with .In are taken to be the result of an earlier invocation of lint with either the -c or the -o 
option used. The .In files are analogous to .o (object) files that are produced by the cc(l) com- 
mand when given a .c file as input. Files with other suflBxes are warned about and ignored. 

Lint will take all the .c, .In, and Uib-lz.ln files (specified by -Ix and process them in their com- 
mand line order. By default, lint appends the standard C lint library (llib-lc.ln) to the end of 
the list of files. However, if the -p option is used, the portable C lint library (llib-port.ln) is 
appended instead. When the -c option is not used, the second pass of lint checks this list of files 
for mutual compatibility. When the -c option is used, the .In and the llib-li.ln files are ignored. 

Any nmnber of lint options may be used, in any order, intermixed with file name arguments. The 
following options are used to suppress certain kinds of complaints: 

-a Suppress complaints about assignments of long values to variables that are not 

long. 

-b Suppress complaints about break statements that cannot be reached. (Pro- 

grams produced by lex or yacc will often result in many such complaints). 

-h Do not apply heuristic tests that attempt to intuitively find bugs, improve style, 

and reduce waste. 

-u Suppress complaints about functions and external variables used and not defined, 

or defined and not used. (This option is suitable for running lint on a subset of 
files of a larger program.) 

-V Suppress complaints about imused argmnents in functions. 

-X Do not report variables referred to by external declarations but never used. 

The following arguments alter linfs behavior: 

-Ix Include additional lint library Uib-li.ln. For example, you can include a lint 

version of the Math Library llib-lm.ln by inserting -Im on the command line. 
This argument does not suppress the default use of llib-lc.ln. These lint 
libraries must be in the assmned directory. This option can be used to reference 
local lint libraries and is useful in the development of multi-file projects. 

-n Do not check compatibility against either the standard or the portable lint 

library. 

-p Attempt to check portability to other dialects of C. Along with stricter check- 

ing, this option causes all non-external names to be tnmcated to eight characters 
and all external names to be tnmcated to six characters and one case. 
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-c Cause lint to produce a .In file for every .c file on the command line. These .In 

files are the product of lint's first pass only, and are not checked for mter- 
function compatibility. 

-o lib Cause lint to create a lint library with the name llib-l/t6.1n. The -c option 

nullifies any use of the -o option. The lint library produced is the input that is 
given to lint'a second pass. The -o option simply causes this file to be saved in 
the named lint Ubrary. To produce a Ilib-l/t6.1n without extraneous messages, 
use of the -x option is suggested. The -v option is useful if the source file(s) for 
the lint library are just external interfaces (for example, the way the file llib-lc is 
written). These option settings are also available through the use of "lint com- 
ments" (see below). 

The -D, -U, and -I options of cpp(l) and the -g, and -O, options of cc(l) are also recognized 
as separate arguments. The -g and -O options are ignored, but, by recognizing these options, 
lint'a behavior is closer to that of the cc(l) command. Other options are warned about and 
ignored. The pre-processor symbol "lint" is defined to allow certain questionable code to be 
altered or removed for lint. Therefore, the sjrmbol "lint" should be thought of as a reserved word 
for all code that is planned to be checked by lint. 

Certain conventional conmients in the C source will change the behavior of lint: 

/*NOTREACHED*/ 

at appropriate points stops comments about umreachable code. (This comment is 
typically placed just after calls to functions like exit{2)). 

/♦VARARGSn*/ 

suppresses the usual checking for variable numbers of arguments in the following 
function declaration. The data types of the first n arguments are checked; a 
missing n is taken to be 0. 

/*ARGSUSED*/ 

turns on the -v option for the next function. 

/*LINTLIBRARY*/ 

at the begiiming of a file shuts off complaints about imused functions and func- 
tion arguments in this file. This is equivalent to using the -v and -x options. 

Lint produces its first output on a per-source-file basis. Complaints regarding included files are 
collected and printed after all source files have been processed. Finally, if the -c option is not 
used, information gathered fi:om all input files is collected and checked for consistency. At this 
point, if it is not clear whether a complaint stems from a given source file or from one of its 
included files, the soiurce file name will be printed followed by a question mark. 

The behavior of the -c and the -o options allows for incremental use of lint on a set of C soiurce 
files. Generally, one invokes lint once for each source file with the -c option. Each of these invo- 
cations produces a .In file which corresponds to the .c file, and prints all messages that are about 
just that source file. After all the source files have been separately run through lint, it is invoked 
once more (without the -c option), listing all the .in files with the needed -Ix options. This will 
print all the inter-file inconsistencies. This scheme works well with make{l); it allows make to be 
used to lint only the source files that have been modified since the last time the set of source files 
were linted. 

HARDWARE DEPENDENCIES 

Series 200, Series 300, Series 500 

Lint utilizes a special version of the C compiler front end. The size of the internal com- 
piler tables can be adjusted by using the -N option. The syntax for this option is 
described in the HARDWARE DEPENDENCIES section of the manual page for cc(l). 
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The following option is supported: 
-Y Enable support of 16-bit characters inside string hterals and conunents. Note that 8-bit 



parsing is always supported. See hpnl9{5) for more details on International Support. 



FILES 



/usr/lib 

/usr/lib/lint[12] 
/usr/lib/Uib-lchi 

/usr/lib/Uib-port.hi 

/usr/lib/Uib-lm.ln 



the directory where the lint libraries specified by the -\x option must 

exist 

first and second passes 

declarations for C Library functions (binary format; soiurce is in 

/usr/lib/Uib-lc) 

declarations for portable functions (binary format; source is in 

/usr/lib/lUb-port) 

declarations for Math Library functions (binary format; soinrce is in 

/usr/lib/Uib-lm) 

temporaries 



/usr/tmp/*lint* 

SEE ALSO 

cc(l), cpp(l), make(l). 

WARNINGS 

Exit{2), longjmp (on 3etjmp{SC)), and other functions that do not retmn are not understood; this 
causes various inaccuracies. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

lock - reserve a tenninal 

SYNOPSIS 
lock 

DESCRIPTION 

Lock requests a password from the user, then prints "This terminal is locked — do not disturb" on 
the terminal and refuses to relinquish the tenninal until the password is repeated. If the user for- 
gets the password, he has no other recourse but to login elsewhere and kill the lock process. 

BUGS 

Should timeout after 15 minutes. 
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NAME 

login - sign on 

SYNOPSIS 

login [ name [ env-var . . . ] ] 
login - -r rhost 

DESCRIPTION 

The login conunand is used at the beginning of each terminal session and allows you to identify 
yourself to the system. It may be invoked as a command or by the system when a connection is 
first established. Also, it is invoked by the system when a previous user has terminated the initial 
shell by typing a cntrl-d to indicate an "end-of-file." 

If login is invoked as a command it must replace the initial command interpreter. This is accom- 
plished by typing: 
exec login 
from the initial shell. 

Login asks for your user name (if not supplied as an argument), and, if appropriate, yoiu: pass- 
word. Echoing is turned off (where possible) during the tjrping of your password, so it will not 
appear on the written record of the session. An invalid login name will cause a request for a pass- 
word. This is done to make it more difficult for an unauthorized user to log in on the system by 
trial and error. After three imsuccessful login attempts, a hangup signal is issued. 

The -r option is only useful on those installations which support the Berkeley remote login service 
rlogin. This option is used by the rlogin server to inform login that a remote login is being 
attempted from the given remote hostname rhost. Login then reads the remote user's name 
remuaer, the local user's name locuser, and the user's remote terminal type. Login then uses the 
following three conditions to decide if the user can be logged in without asking for a password: 

The remote host rhost appears in the file /etc/hosts.equiv and remuser = locuser. 

The file SHOME/.rhosts contains a line listing just rhost and remuaer = locuser, where 
$HOME is locuser's login directory. 

The file SHOME/.rhosts contains a line listing the remote host rhost followed by the 
remote user remuser, seperated by exactly one space. 

If none of these conditions are met, then a password is prompted for as if locuser had been 
specified as the user name on the command line. Once the user is logged in, login proceeds as in a 
normal login. 

For security reasons, the following conditions also apply to the -r option: 

Login must be rmming as the super-user (uid = 0). 

If attempting to login as the super-user (uid = 0), then the file /etc/hosts.equiv is not 
checked, though the file SHONfE/.rhosts is still searched. 

The file $HOM£/.rho8t8 must be owned either by locuser or by the super-user. 

The file $HOME/.rhosts must not be a symbolic link on those installations which sup- 
port them. 

At some installations, an option may be invoked that will require you to enter a second "dialup" 
password. This will occin: only for dial-up connections, and will be prompted by the message 
"dialup password:". Both passwords are required for a successful login. See dialups{4) for details 
on dialup security. 

If password aging has been invoked by the super-user on your behalf, your password may have 
expired. In this case, you will be diverted into passwd{l) to change it, after which you may 
attempt to login again. 
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If you do not complete the login succrasfully within a certain period of time (e.g., one minute), 
you will be silently disconnected. 

After a successful login, the accounting files are updated, the command interpreter (usually 8h{l)) 
is determined, and the user and group id's, group access list, and working directory are initialized. 
These specifications are found in the /etc/passwd and /etc/logingroup file entries for the user. 
The name of the command mterpreter as passed to it is - followed by the last component of the 
interpreter's pathname (i.e., -sh). If this field in the password file is empty, then the default 
command interpreter, /bin/sh is used. The command interpreter performs its own initialization, 
and does login initialization if the name by which it is called starts with -. 

If 8h{l) is the command interpreter, it executes the profile files /etc/profile and 
$HOME/.profile if they exist. Depending on what these profile files contain, you are notified of 
mail in your mail file or any messages you may have received since your last login. 

If the command name field is "*", then a chroot{2) is done to the directory named in the direc- 
tory field of the entry. At that point login is re-executed at the new level which must have its 
own root structure, including /etc/login and /etc/passwd. 

The basic environment (see environ{5)) is initialized to: 

HOME=your-login-direetory 
PATH=:/bin:/usr/bin 
SHELL=laat-field-of-pasawd-entry 
MAIL=/usr/mail/your-/oj?in-nome 
TZ= timezone-specification 

For the super-user, PATH is augmented to include /etc. In the case of a remote login, the enviro- 
ment variable TERM is also set to the remote user's terminal type. 

The environment may be expanded or modified by supplying additional arguments to login, either 
at execution time or when login requests your login name. The arguments may take either the 
form XXX or xxx=yyy. Argmuents without an equal sign are placed in the environment as 

Lfi=xxx 
where n is a number starting at and is incremented each time a new variable name is required. 
Variables containing an = are placed into the enviromnent without modification. If they already 
appear in the enviromnent, then they replace the older value. There are two exceptions. The 
variables PATH and SHELL cannot be changed. This prevents people, logging into restricted 
shell enviromnents, firom spawning secondary shells which are not restricted. Both login and getty 
understand simple single-character quoting conventions. Typing a backslash in front of a charac- 
ter quotes it and allows the inclusion of such things as spaces and tabs. 

If /etc/btmp is present, all unsuccessfiil login attempts are logged to this file. This feature is 
disabled if the file is not present. A smnmary of bad login attempts may be viewed using lastb, 
see last{l). 

If /etc/securetty is present, login security is in eflFect and the super-user may only login success- 
fully on the ttys listed in this file. Ttys are listed by device name, one per line. Valid tty names 
are dependent on installation. Some examples could be "console", "ttyOl", "ttyal", etc. Note 
that this feature does not inhibit a normal iiser from using su. 



FILES 



$HOME/.profile personal profile (individual user initialization) 

$HOME/.rhosts personal equivalence file for the remote login server 

/etc/btmp history of bad login attempts 

/etc/d_pas8wd dialup security encrypted passwords 
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/etc/dialups 

/etc/hosts.equiv 

/etc/logingroup 

/etc/motd 

/etc/passwd 

/etc/profile 

/etc/seciiretty 

/etc/utmp 

/etc/wtmp 

/usr/mail/ your-name 

VARIABLES 

HOME 

PATH 

SHELL 

MAU. 

TERM 

TZ 

XXX 

L XXX 



lines which require dialup security 

system list of equivalent hosts allowing logins without passwords 

group file - defines group access lists 

message-of-the-day 

password file - defines users, passwords, and primary groups 

system profile (initialization for all users) 

list of valid ttys for root login 

users cmrently logged in 

history of logins, logouts, and date changes 

mailbox for user your-name 



The users home directory. 

The path to be searched for commands. 

Which command interpreter is being used. 

Where to look for mail. 

The user's terminal type. 

The ciurent timezone. 

User specified named variables. 

User specified unnamed variables. 

SEE ALSO 

last(l), mail(l), newgrp(l), passwd(l), sh(l), su(l), getty(lM), initgroups(3C), dialups(4), 
group(4), pa8swd(4), profile(4), utmp(4), environ(5). 

DIAGNOSTICS 

The following diagnostics will appear if problems occur: 

Login incorrect: 

if the user name or the password cannot be matched. 

No shell, cannot open password file, or no directory: 

consult your system manager. 

Your password has expired. Choose a new one: 

if password aging is implemented. 

No Root Directory: 

attempted to log into a subdirectory that does not exist (i.e., passwd file entry 
had shell name "*", but the system cannot chroot to the given directory). 

No /bin/login or /etc/login on root: 

same as above except sub-root login command not found. 

Bad user id. or Bad group id.: 

setuid or aetgid failed. 

Unable to change to directory <name>: 

cannot chdir to your home directory. 

No shell: your shell (or /bin/sh if yoiu: shell name is null in /etc/passwd) could not be 

eiec'd. 
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Sorry, single-user: 

occurs if the version field from unaTne{2) starts with A (or if the uname system 
call fails) and if your terminal name is not /dev/console and if your home shell is 
not named /usr/lib/uucp/uucico. You are not logged in. 

No utmp entry. You must exec "login" from the lowest level "sh": 

if you attempted to execute login as a command without using the shell's exec 
internal command or from other than the initial shell. 

.rhosts is a soft link: 

if your personal equivalence file is a symbolic link. 

Bad .rhosts ownership: 

if your personal equivalence file is not owned by the local user or by the super- 
user. 

Remuser too long, locuser too long, or terminal type too long: 

if the indicated string was too long for login 'a internal buffer. 

AUTHOR 

Login was developed by AT&T and HP. 
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NAME 

logname - get login name 

SYNOPSIS 

logname 

DESCRIPTION 

Lognamp returns the contents of the environment variable $LOGNAME, which is set when a user 
logs into the system. 

FILES 

/etc/profile 

SEE ALSO 

env(l), login(l), logname(3X), environ(5). 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file ... 

DESCRIPTION 

The input is one or more object or library archive files (see ar(l)). The standard output is a list 
of pairs of object file names, meaning that the first file of the pw refers to external identifiers 
defined in the second. The output may be processed by taort{\) to find an ordering of a library 
suitable for one-pass access by /</(!). Note that the link editor ld{\) is capable of multiple passes 
over an archive in the archive format and does not require that lorder{\.) be used when building 
an archive. The usage of the lorder{l) command may, however, allow for a slightly more efficient 
access of the archive during the link edit process. 

The foUowing example builds a new library from existing .o files, 
ar cr library '■ lorder *.o | tsort^ 

FILES 

♦symref, *symdef temporary files 

SEE ALSO 

ar(l), ld(l), tsort(l). 

BUGS 

Object files whose names do not end with .o, even when contained in library archives, are over- 
looked. Their global symbols and references are attributed to some other file. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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Ip, cancel - send/cancel requests to an LP line printer 



toption] [-a] [-t title] [-w] files 



SYNOPSIS 

Ip M [-ddest] [-m] [-nnumber] 
cancel [ids] [printers] 

DESCRIPTION 

Lp arranges for the named files and associated information (collectively called a request) to be 
printed by a line printer. If no file names are mentioned, the standard input is assimied. The file 
name - stands for the standard input and may be suppUed on the command line in conjunction 
with named files. The order in which files appear is the same order in which they will be printed. 

Lp associates a unique id with each request and prints it on the standard output. This id can be 
used later to cancel (see cancel) or find the status (see lpstat{l)) of the request. 

The following options to lp may appear in any order and may be intermixed with file names: 

-c Make copies of the files to be printed immediately when lp is invoked. Normally, files 

will be linked into a spool directory. Ownership and mode of the linked files remains 
imchanged. If the -c option is given or linking is not possible then files are copied, in 
which case the ownership and mode are set to allow read access to owner lp and group 
bin only. It should be noted that if the files are linked rather than copied, any 
changes made to the named files after the request is made but before it is printed will 
be reflected in the printed output. 

-ddest Choose dest as the printer or class of printers that is to do the printing. If dest is a 
printer, then the request will be printed only on that specific printer. If dest is a class 
of printers, then the request will be printed on the first available printer that is a 
member of the class. Under certain conditions (printer imavadlability, file space limi- 
tation, etc.), requests for specific destinations may not be accepted (see accept{iM.) 
and lpstat{l)). By default, dest is taken from the environment variable LPDEST (if it 
is set). Otherwise, a default destination (if one exists) for the computer system is 
used. Destination names vary between systems (see lpstat{l)). 

-m Send mail (see mail(l)) after the files have been printed. By default, no mail is sent 

upon normal completion of the print request. 

-nnumber Print number copies (default of 1) of the output. 

-ooption Specify printer-dependent or* class-dependent options. Several such options may be 
collected by specifying the -o keyletter more than once. For more information about 
what is valid as options for printers supported on yoiu: hardware, see the mA;/p(lM) 
script. 

-8 Suppress messages from /p(l) such as "request id is ...". 

-ttitle Print title on the banner page of the output. 

-w Write a message on the user's terminal after the files have been printed. If the user is 

not logged in, then mail will be sent instead. 

Cancel cancels line printer requests that were made by the lp(l) command. The command line 
argtmients may be either request ids (as returned by lp{l)) or printer names (for a complete list, 
use lpstat{l)). Specifying a request id cancels the associated request even if it is currently print- 
ing. Specifying a printer cancels the request which is currently printing on that printer. In either 
case, the cancellation of a request that is currently printing frees the printer to print its next 
available request. 

EXAMPLES 



Hewlett-Packard Company 



- 1- 



Version B.l, October 1986 



LP(1) HP-UX LFCl) 



A^uming there is an existing Hewlett-Packard 2934A line printer named ipS, configured with the 
hp2934a model interface program. This model has the -c option which will cause the printer to 
print in a compressed mode. To obtain compressed print on lp8, use the command: 

Ip -dlp2 -oc files 

FILES 

/usr/spool/lp/* 

HARDWARE DEPENDENCIES 

Series 200, 300, 800 
See also slp{l). 

SEE ALSO 

accept(lM), enable(l), Ipadmin(lM), Ipsched(lM), Ipstat(l), mail(l), mklp(lM). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

Ipstat - print LP status information 

SYNOPSIS 

Ipstat [options] 

DESCRIPTION 

Lpstat prints information about the current status of the LP line printer system. 

If no options are given, then Ipstat prints the status of all requests made to /p(l) by the user. 
Any arguments that are not options are assiuned to be request ids (as returned by Ip). Lpstat 
prints the status of such requests. Options may appear in any order and may be repeated and 
intermixed with other arguments. Some of the keyletters below may be followed by an optional 
list that can be in one of two forms: a list of items separated from one another by a comma, or a 
list of items enclosed La double quotes and separated from one another by a comma and/or one or 
more spaces. For example: 

-u"userl, user2, userS" 

The omission of a list following such keyletters causes all information relevant to the keyletter to 
be printed, for example: 

Ipstat -o 

prints the status of all output requests. 

-a[/fs<] Print acceptance status (with respect to Ip) of destinations for requests. List is a list of 
intermixed printer names and class names. 

-c[ list] Print class names and their members. List is a list of class names. 

-d Print the system default destination for Ip. 

-o[list] Print the status of output requests. List is a list of intermixed printer names, class 
names, £ind request ids. 

-p[ list] Print the status of printers. List is a list of printer names. 

-r Print the status of the LP request scheduler 

-8 Print a status svunmary, including the status of the line printer scheduler, the system 

default destination, a list of class names and their members, and a list of printers and 
their associated devices. 

-t Print all status information. 

— u[ list] Print status of output requests for users. List is a list of login names. 

-v(/ta<] Print the names of printers and the pathnames of the devices associated with them. 



List is a list of printer names. 



FILES 



/usr/spool/lp/* 

SEE ALSO 

enable(l), lp(l). 

INTERNATIONAL SUPPORT 

messages. 
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NANfE 

is, i, ii, isf, Isr, isx - list contents of directories 

SYNOPSIS 

Is [ -RaAdCxmlnoglrtucpFbqisf ] [names] 

I [is options] [ names ] 

II [is options] [ names ] 
Isf [Is options] [ names ] 
Isr [Is options] [ names ] 
Isx [Is options] [ names ] 

DESCRIPTION 

For each directory argument, Is lists the contents of the directory; for each file argument. Is 
repeats its name and any other information requested. The output is sorted alphabetically by 
default. When no argument is given, the current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but file arguments appear before directories 
and their contents. 

If you are the super-user, all files except . and .. are listed by default. 

There are three major listing formats. The format chosen depends on whether the output is going 
to a login device, and may also be controlled by option flags. The default format for a teletype is 
to list the contents of directories in multi-column format, with the entries sorted down the 
columns. (When individual file names (as opposed to directory names) appear in the argument 
list, those file names are always sorted across the page rather than down the page in coliunns. 
This is because the individual file names may be arbitrarily long.) If the standard output is not a 
teletype, the default format is to list one entry per line, the -C and -x options enable multi- 
colunm formats, and the -m option enables stream output format in which files are listed across 
the page, separated by commas. In order to determine output formats for the -C, -x, and -m 
options, Is uses an environment variable, COLUMNS, to determine the number of character posi- 
tions available on one output line. If this variable is not set, the terminfo database is used to 
determine the ntunber of columns, based on the environment variable TERM. If this information 
cannot be obtained, 80 columns is assumed. 

Options 

There are niunerous options: 

-R Recursively list subdirectories encountered. 

-a List all entries; usually entries whose names begin with a period (.) are not listed. 

-A The same as -a, except that the ciurrent directory "." and parent directory ".." are not 
listed. For the super-user, this flag defaults to ON, and is turned oflF by -A. 

-d If an argument is a directory, list only its name (not its contents); often used with -1 to 
get the status of a directory. 

-C Multi-coliunn output with entries sorted down the columns. 

-X Multi-column output with entries sorted across rather than down the page. 

-m Stream output format. 

-1 List in long format, giving mode, number of links, owner, group, size in bytes, and time of 

last modification for each file (see below). If the file is a special file, the size field will 
instead contain the major and minor device niunbers rather than a size. 

-n The same as -1, except that the owner's UID and group's GID numbers are printed, 
rather than the associated character strings. 

-o The same as -1, except that only the owner is printed (group is omitted.) (If both -1 and 
-o are specified, the group is not printed.) 
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-g The same as -1, except that only the group is printed (owner is omitted.) (If both -1 and 

-g are specified, the owner is not printed.) 

-1 The file names will be listed in single column format regardless of the output device. This 
will force single column format to the user's terminal. 

-r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

-t Sort by time modified (latest first) instead of by name. 

-u Use time of last access instead of last modification for sorting (with the -t option) or 
printing (with the -1 option). 

-c Use time of last modification of the inode (file created, mode changed, etc.) for sorting 

(-t) or printing (-1). 

-p Put a slash (/) after each file name if that file is a directory. 

-F Put a slash (/) after each file name if that file is a directory, and put an asterisk (*) after 
each file name if that file is executable. 

-b Force printing of non-graphic characters to be in the octal \ddd notation. 

-q Force printing of non-graphic characters in file names as the character (?). 

-i For each file, print the i-nimiber in the first column of the report. 

-8 Give size in blocks, including indirect blocks, for each entry. 

-f Force each argiunent to be interpreted as a directory and list the name foimd in each slot. 

This option tmns off -1, — t, -s, and — r, and turns on -a; the order is the order in which 
entries appear in the directory. 

Ls normally is known by several names which provide shorthands for the various formats: 

I is equivalent to is -m. 

II is equivalent to Is -1. 
Isf is equivalent to Is -F. 
Isr is equivalent to Is -R. 
Isx is equivalent to Is -x. 

The shorthand notations are implemented as links to Is. Option argmnents to the shorthand ver- 
sions behave exactly as if the long form above had been used with the additional arguments. 

The mode printed under the -1 option consists of 10 characters that are interpreted as follows: 

The first character is: 

d if the entry is a directory; 

b if the entry is a block special file; 

c if the entry is a character special file; 

p if the entry is a fifo (a.k.a. "named pipe") special file; 

n if the entry is a network special file; 

- if the entry is an ordinary file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers 
to the owner's permissions, the next to permissions of others in the user-group of the file, 
and the last to all others. Within each set, the three characters indicate permission to 
read, to write, and to execute the file as a program, respectively. For a directory, "exe- 
cute" permission is interpreted to mean permission to search the directory for a specified 
file. 

The permissions are indicated as follows: 
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r if the £Qe is readable; 

w if the file is writable; 

X if the file is executable; 

- if the indicated permission is not granted. 

The group)-execute permission character is given as s if the file has set-group-ID mode; 
likewise, the user-execute permission character is given as s if the file has set-user-ID 
mode. The last character of the mode (normally x or -) is t if the 1000 (octal) bit of the 
mode is on; see chmod{l) for the meaning of this mode. The indications of set-ID and 
1000 bits of the mode are capitalized (S and T respectively), if the corresponding execute 
permission is not set. 

When the sizes of the files in a directory are listed, a total coimt of blocks, including indirect 
blocks, is printed. 

HARDWARE DEPENDENCIES 

Integral PC: 

The file type n is not supported. 

Series 500: 

The -a and -A options perform the same function. 

FILES 

/etc/passwd to get user IDs for is -1 and Is -o. 

/etc/group to get group IDs for Is -1 and is -g. 

/usr/lib/terminfo/?/* to get terminal information. 

AUTHOR 

Ls was developed by AT&T and the University of California, Berkeley California, Computer Sci- 
ence Division, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

chmod(l), find(l). 

BUGS 

The option setting based on whether the output is a teletype is imdesirable as Is -s is much 
different than Is -s I Ipr. On the other hand, not using this setting would make old shell scripts 
which used Is almost inevitably fail. 

Unprintable characters in file names may confuse the coliunnar output options. 

INTERNATIONAL SUPPORT 

Is: 8-bit filenames, messages. 
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NAME 

Isdev - list device drivers in the system 

SYNOPSIS 

/etc/lsdev [ major... ] 

Remarks: 

This manual page describes Ladev as implemented on the Series 200. 

Not 8uppori;ed on the Integral Personal Computer. 

DESCRIPTION 

With no arguments, ladev lists the major device ntunbers, for block and character files, and driver 
names of all device drivers configured into the system and avedlable for invocation via special files. 
A "-1" in either the block or character colmnn means that a major munber does not exist for that 
type. 

If there are any argiunents, they must represent major device numbers. The corresponding driver 
name, if any, will be printed for each argument. Some nmnbers will return two driver names, one 
for the block and one for the character. 

Ladev is simply a quick-reference aid. In some implementations, it may only read an internal list 
of device drivers, not the actual list in the operating system. 

SEE ALSO 

Section 4. 

DIAGNOSTICS 

Lists the drivemame as "no such driver" when appropriate. 
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NAME 

Isdev - list device drivers in the system 

SYNOPSIS 

/etc/lsdev [ major... ] 

Remarks: 

This manual page describes Isdev as implemented on the Series 500. 
not supported on the Integral Personal Computer. 

DESCRIPTION 

With no arguments, Isdev lists, one pair per line, the major device numbers and driver names of 
all device drivers configured into the system and available for invocation via special files. 

If there are any arguments, they must represent major device numbers. For each, Udev lists the 
corresponding driver name (if any). 

Lsdev is simply a quick-reference aid. In some implementations, it may only read an internal list 
of device drivers, not the actual list in the operating system. 

SEE ALSO 

Section 4. 

DIAGNOSTICS 

Lists the drivemame as "no such driver" when appropriate. 
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NAME 

Issf - list a special file 

SYNOPSIS 

Issf [-f devfile] path... 

DESCRIPTION 

Laaf lists a special file. The -f option specifies devfile, which is a file that describes drivers and 
pseudo-drivers. This file is generated by vagen{\). If the -f option is not present, then the file 
/etc/devices is used. 

For each path, lasf determines the major nimiber of the special file and whether it is block or char- 
acter (using atat{^)). Laaf scans devfile for the driver which matches the major niunber of the 
special file. When the driver is found, the minor niunber of the special file is decoded and a 
mnemonic description is printed on standard output. The mnemonics used to describe the minor 
niunber fields are closely related to the options used with mA»/(l) which makes a special file. 

As an example, suppose a special file is created with this command "mksf -d discO -1 1 -u 2 -s 3 
dsk/cld2s3". The command 'Issf dsk/cld2s3'' will output "discO lu 1 imit 2 section 3 
dsk/cld2s3". 

AUTHOR 

Laafwas developed by HP. 

FILES 

/etc/devices 

SEE ALSO 

mksf(l), m8f(l). 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ options ] [ files ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of the 
argument files is processed in order, if there are no files, or if a file name is -, the standard input 
is read. The processed text is written on the standard output. 

The options and their eflFects are as foUows: 

-e Operate interactively. Interrupts are ignored and the output is unbufiered. Using this 

mode may be very difficult. 

-8 Enable line sync output for the C preprocessor (#line . . . ) 

-Bint Change the size of the push-back and argument coUection buffers from the default of 
4,096. 

-Hint Change the size of the symbol table hash array from the default of 199. The size should 
be prime. 

-Sint Change the size of the call stack from the default of 100 slots. Macros take three slots, 
and non-macro arguments take one. 

-Tint Change the size of the token buffer from the default of 512 bjrtes. 

To be effective, these flags must appear before any file names and before any -D or -U flags: 

-Jiname[=val] 

Defines name to val or to null in va/'s absence. 

-Vname 

undefines name. 

Macro calls have the form: 

name(argl,arg2, . . ., argn) 

The ( must immediately follow the name of the macro. If the name of a defined macro is not fol- 
lowed by a (, it is deemed to be a call of that macro with no arguments. Potential macro names 
consist of alphabetic letters, digits, and underscore _, where the first character is not a digit. 

Leading unquoted blanks, tabs, and new-lines are ignored while collecting arguments. Left and 
right single quotes are used to quote strings. The value of a quoted string is the string stripped of 
the quotes. 

When a macro name is recognized, its arguments are collected by searching for a matching right 
parenthesis. If fewer arguments are supplied than are in the macro definition, the trailing argu- 
ments are taken to be null. Macro evaluation proceeds normally during the collection of the argu- 
ments, and any commas or right parentheses which happen to tiun up within the value of a 
nested call are as effective as those in the original input text. After argiunent collection, the value 
of the macro is pushed back onto the input stream and rescanned. 

M4 makes available the following built-in macros. They may be redefined, but once this is done 
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the original meaning is lost. Their values are null unless otherwise stated. 

define the second argiunent is installed as the value of the macro whose name is the first 

argument. Each occiurence of $n in the replacement text, where n is a digit, is 
replaced by the n-th argument. Argument is the name of the macro; missing 
arguments are replaced by the null string; $# is replaced by the nvunber of argu- 
ments; $* is replaced by a list of all the arguments separated by commas; @ $@ is 
like $*, but each argument is quoted (with the ciirrent quotes). 

\mdefine removes the definition of the macro named in its argument. 

defii returns the quoted definition of its argument(s). It is useful for renaming macros, 

especially built-ins. 

pushdef like define, but saves any previous definition. 

popdef removes current definition of its argument(8), exposing the previous one, if any. 

ifdef if the first argument is defined, the value is the second argument, otherwise the 

third. If there is no third argument, the value is null. The word unii is predefined 
on HP-UX system versions of m4 ■ 

shift retiums all but its first argument. The other arguments are quoted and pushed back 

with commas in between. The quoting nullifies the effect of the extra scan that will 
subsequently be performed. 

changequote change quote symbols to the first and second argmnents. The symbols may be up to 
five characters long. Changequote without arguments restores the original values 
(i.e., - ')• 

changecom change left and right comment markers from the default # and new-line. With no 
arguments, the comment mechanism is effectively disabled. With one argiunent, the 
left marker becomes the argmnent and the right marker becomes new-line. With 
two argmnents, both markers are affected. Comment markers may be up to five 
characters long. 

divert m4 maintains 10 output streams, nimibered 0-9. The final output is the concatena- 

tion of the streams in nmnerical order; initially stream is the current stream. The 
divert macro changes the cturent output stream to its (digit-string) argiunent. Out- 
put diverted to a stream other than through 9 is discarded. 

undivert causes immediate output of text from diversions named as arguments, or all diver- 
sions if no argimient. Text may be undiverted into another diversion. Undiverting 
discards the diverted text. 

divnmn returns the value of the cmrent output stream. 

dnl reads and discards characters up to and including the next new-line. 

ifelse has three or more arguments. If the first argument is the same string as the second, 

then the value is the third argument. If not, and if there are more than foiu: argu- 
ments, the process is repeated with argmnents 4, 5, 6 and 7. Otherwise, the value is 
either the foiui;h string, or, if it is not present, null. 

incr returns the value of its argument incremented by 1. The value of the argument is 

calculated by interpreting an initial digit-string as a decimal nimaber. 

deer returns the value of its argument decremented by 1. 

eval evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Opera- 

tors include -|-, -, *, /, %, ** 

(exponentiation), bitwise Sc, |, ", and ~; relationals; parentheses. Octal and hex 
numbers may be specified as in C. The second argument specifies the radix for the 
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result; the default is 10. The third argument may be used to specify the TniniTniim 
number of digits in the result. 

len returns the number of characters in its argument. 

index returns the position m its first argument where the second argument begins (zero 

origin), or -1 if the second argument does not occur. 

substr returns a substring of its first argmnent. The second argument is a zero origin 

number selecting the first character; the third argument indicates the length of the 
substring. A missing third argument is taken to be large enough to extend to the 
end of the first string. 

transliterates the characters in its first argument from the set given by the second 
argument to the set given by the third. No abbreviations are permitted. 

returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is inaccessible. 

executes the HP-UX system command given in the first argument. No value is 
returned. 

is the retmn code from the last call to syscmd. 

fills in a string of XXXXX in its argument with the current process ID. 

causes immediate exit from m^. Argument 1, if given, is the exit code; the default is 
0. 

argument 1 will be pushed back at final EOF; example: m4wrap( ^ cleanup( ) ' ) 

prints its argument on the diagnostic output file. 

prints current names and definitions, for the named items, or for all if no argiunents 
are given. 

with no arguments, turns on tracing for all macros (including built-ins). Otherwise, 
turns on tracing for named macros. 

turns off trace globally and for any macros specified. Macros specifically traced by 
traceon can be untraced only by specific calls to traceoff. 



translit 

include 

sinclude 

syscmd 

sysval 

maketemp 

m4exit 

m4wrap 
errprint 
dmnpdef 

traceon 

traceoff 

SEE ALSO 

cc(l), cpp(l). 
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NAME 

hp9000s200, hp9000s300, hp9000s500, hp9000s8(K), pdpll, u3b, u3b5, vax - provide truth value 
about your processor type 

SYNOPSIS 

hpg0008200 

hp90008300 

hp9000B500 

hp90008800 

pdpll 

u3b 

u3b5 

vax 

DESCRIPTION 

The following commands will return a true value (exit code of 0) if you are on a processor that 
the conunand name indicates. 

hp9000s200 

True if you are on a Hewlett-Packard 9000 Series 200. 

hpgOOOsSOO 

True if you are on a Hewlett-Packard 9000 Series 300. 

hpgOOOsSOO 

True if you are on a Hewlett-Packard 9000 Series 500. 

hpOOOOsSOO 

True if you are on a Hewlett-Packard 9000 Series 800. 

pdpll True if you are on a PDP-11/45 or PDP-11/70. 

u3b True if you are on a 3B 20S computer. 

u3b5 True if you are on a 3B 5 computer. 

vax True if you are on a VAX-11/750 or VAX-11/780. 

The commands that do not apply will retinrn a false (non-zero) value. These commands are often 
used within make{l) makefiles and shell procedures to increase portability. 

SEE ALSO 

make(l), sh(l), test(l), true(l). 
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NAME 

mail, rmail - send mail to users or read mail 

SYNOPSIS 

mail [ -epqr ] [ -f file ] 

mail [ -t ] ( -d ] persons 

rmail [ -t ] [ -d ] persons 

DESCRIPTION 

Note: An enhanced user mail interface is presented in mailx{l). 

Mail without arguments prints a user's mail, message-by-message, in last-in, first-out order. For 
each message, the user is prompted with a ?, and a line is read from the standard input to deter- 
mine the disposition of the message: 

<new-line> Go on to next message. 

-|- Same as <new-line>. 

n Same as <new-line>. 

d Delete message and go on to next message. 

p Print message again. 

- Go back to previous message. 

s [ files ] Save message in the named files (mbox is default). 

w [ files ] Save message, without its header, in the named files (mbox is default). 

y [ files ] Same as w. 

m [ persons ] Mail the message to the named persons (yourself is default). 

q Put undeleted mail back in the mailfile and stop. 

EOT (control-d) 

Same as q. 

X Put all mail back in the mailfile unchanged and stop. 

I command Escape to the command interpreter to do command. 

* Print a command summary. 

The optional argmnents alter the printing of the mail: 

-e causes mail not to be printed. An exit value is returned: 

= mail present 

1 = no mail 

2 = other error 

-p causes all mail to be printed without prompting for disposition. 

-q causes mail to terminate after interrupts. Normally an interrupt only causes the 

termination of the printing of the current message. 

-r causes messages to be printed in first-in, first-out order. 

-{file causes mail to use file (e.g., mbox) instead of the default mailfile. 

When persons sue named, mail takes the standard input up to an end-of-file (or up to a line con- 
sisting of just a .) £ind adds it to each person's mailfile. The message is preceded by the sender's 
name and a postmark. Lines that look like postmarks in the message, (i.e., "From . . .") are pre- 
ceded with a >. The -t option causes the message to be preceded by all persons the mail is sent 
to. A person is usually a user name recognized by login{l). If a person being sent mail is not 
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recognized, or if mail is interrupted during input, the file dead.letter will be saved to allow edit- 
ing and resending. Note that this is regarded as a temporary file in that it is recreated every time 
needed, erasing the previous contents of dead.letter. 

The -d option causes mail to deliver mail directly. This isolates mail from making routing deci- 
sions and allows it to be iised as a local delivery agent. Typically this option is used by auto- 
routing facilities when they deliver nudl locally. 

To denote a recipient on a remote system, prefix person by the system name and exclamation 
mark (see u«cp(l)). Everything after the first exclamation mark in persona is interpreted by the 
remote system. In particular, if persons contains additional exclamation marks, it can denote a 
sequence of machines through which the message is to be sent on the way to its ultimate destina- 
tion. For example, specifying a!b!cde as a recipient's name causes the message to be sent to user 
b!cde on system a. System a will interpret that destination as a request to send the message to 
user cde on system b. This might be useful, for instance, if the sending system can access system 
a but not system b, and system a has access to system b. Mail will not use uucp if the remote 
system is the local system name (i.e., localsystemluser). 

The mailfile may be manipulated in two ways to alter the function of mail. The other permis- 
sions of the file may be read-write, read-only, or neither read nor write to allow different levels of 
privacy. If changed to other than the default, the file will be preserved even when empty to per- 
petuate the desired permissions. The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded to person. This is espe- 
cially useful to forward all of a person's mail to one machine in a multiple machine environment. 
In order for forwarding to work properly the mailfile should have "mail" as group ID, and the 
group permission should be read-write. 

Rmail only permits the sending of mail; uucp(l) uses rmail as a security precaution. 

When a user logs in, the presence of mail, if any, is indicated. Also, notification is made if new 
mail arrives while using mail. 

FILES 

/usr/mail/*.lock lock for mail directory 

dead.letter unmailable text 

/tmp/ma* temporary file 

$MAIL variable containing path name of mailfile 

$HOME/mbox saved mml 

/etc/passwd to identify sender and locate persons 

/usr/mail/uaer incoming mail for user, i.e., the mailfile 

WARNINGS 

Conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed. Printiug may be forced by typing a p. 

SEE ALSO 

login(l), mailx(l), uucp(l), write(l). 

INTERNATIONAL SUPPORT 

mail: 8- and 16-bit data, 8-bit filenames. 
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NA\fE 

mailx - interactive message processing system 

SYNOPSIS 

mailx [options] [name...] 

DESCRIPTION 

The command mailx provides a comfortable, flexible environment for sending and receiving mes- 
sages electronically. When reading mail, mailx provides commands to facilitate saving, deleting, 
and responding to messages. When sending mail, mailx allows editing, reviewing and other 
modification of the message as it is entered. 

Incoming mail is stored in a standard file for each user, called the system mailbox for that user. 
When mailx is called to read messages, the mailbox is the default place to find them. As messages 
are read, they are marked to be moved to a secondary file for storage, unless specific action is 
taken, so that the messages need not be seen again. This secondary file is called the mbox and is 
normally located in the user's HOME directory (see MBOX, m ENVIRONMENT VARIABLES below 
for a description of this file). Messages remain in this file imtil specifically removed. 

On the command line, options start with a dash (-) and any other arguments are taken to be des- 
tinations (recipients). If no recipients are specified, mailx will attempt to read messages from the 
mailbox. Command line options are: 

-d Turn on debugging output. Neither particularly interesting nor recommended. 

-e Test for presence of mail. Mailx prints nothing and exits with a successful return 

code if there is mail to read. 

-f [filename] Read messages from filename instead of mailbox. If no filename is specified, the 
mbox is used. 

-F Record the message in a file named after the first recipient. Overrides the 

"record" variable, if set (see ENVIRONMENT VARIABLES). 

The number of network "hops" made so far. This is provided for network 
software to avoid infinite delivery loops. 

Print header smnmary only. 

Ignore interrupts. See also "ignore" (ENVIRONMENT VARIABLES). 

Do not initialize from the system default Mailer c file. 

Do not print initial header smnmary. 

Pass address to network delivery software. All tilde commands are disabled. 

Set the Subject header field to subject. 

Read user's mailbox. This is only effective if user's mailbox is not read pro- 
tected. 

-U Convert uucp style addresses to internet standards. Overrides the "conv" 

environment variable. 

When reading mail, mailx is in command mode. A header summary of the first several messages 
is displayed, followed by a prompt indicating mailx can accept regular commands (see COM- 
MANDS below). When sending mail, mailx is in input mode. If no subject is specified on the com- 
mand line, a prompt for the subject is printed. As the message is typed, maih will read the mes- 
sage and store it in a temporary file. Commands may be entered by beginning a line with the 
tilde (~) escape character followed by a single command letter and optional arguments. See 
TILDE ESCAPES for a smnmary of these commands. 
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At any time, the behavior of mailx is governed by a set of environment variables. These are flags 
and valued parameters which are set and cleared via the set and unset commands. See 
ENVIRONMENT VARIABLES below for a summary of these parameters. 

Recipients listed on the command line may be of three types: login names, shell conunands, or 
alias groups. Login names may be any network address, including mixed network addressing. If 
the recipient name begins with a pipe symbol (I), the rest of the name is taken to be a shell com- 
mand to pipe the message through. This provides an automatic interface with any program that 
reads the standard input, such as /p(l) for recording outgoing mail on paper. Alias groups are set 
by the alias command (see COMMANDS below) and are lists of recipients of any type. 

Regular commands are of the form 

[ command ] [ msglist ] [ arguments ] 

If no command is specified in command mode, print is assumed. In input mode, commands are 
recognized by the escape character, and lines not treated as commands are taken as input for the 
message. 

Each message is assigned a sequential number, and there is at any time the notion of a 'ciurent' 
message, marked by a '>' in the header smnmary. Many commands take an optional list of mes- 
sages {msglist) to operate on, which defaults to the current message. A msglist is a list of message 
specifications separated by spaces, which may include: 

n Message number n. 

The current message. 

The first imdeleted message. 
$ The last message. 

* All messages. 

n-m An inclusive range of message nmnbers. 

user All messages from user. 

/string All messages with string in the subject line (case ignored). 

:c All messages of type c, where c is one of: 

d deleted messages 

n new messages 

o old messages 

r read messages 

u unread messages 

Note that the context of the command determines whether this type of message specification 
makes sense. 

Other argmnents are usually arbitrary strings whose usage depends on the conunand involved. 
File names, where expected, are expanded via the normal shell conventions (see sh{l)). Special 
characters are recognized by certain commands and are documented with the commands below. 

At start-up time, mailx reads commands from a system-wide file (/usr/lib/mailx/maibc.rc) to 
initialize certain parameters, then from a private start-up file (SHGME/.mailrc) for personalized 
variables. Most regulsir commands are legal inside start-up files, the most conunon use being to 
set up initial display options and alias lists. The following commands are not legal in the start-up 
file: !, Copy, edit, foUowup, Followup, hold, mail, preserve, reply. Reply, shell, and visusd. 
Any errors in the start-up file cause the remaining lines in the file to be ignored. 
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COMMANDS 

The following is a complete list of mailx commands: 

! command Escape to the shell. See "SHELL" (ENVIRONMENT VARL<IBLES). 

# comment Null command (comment). This may be useful in .mailrc files. 

= Print the current message nmnber. 

? Prints a summary of commands. 

alias alias name... 
group alias name... 

Declare an alias for the given names. The names will be substituted when alias 

is used as a recipient. Useful in the .mailrc file. 

alternates name... 

Declares a list of alternate names for your login. When responding to a message, 
these names are removed fi-om the list of recipients for the response. With no 
arguments, alternates prints the current list of alternate names. See also 
"alhiet" (ENVIRONMENT VAIUABLES). 

cd [director]^ 

chdir [director\^ Change directory. If directory is not specified, $HOME is used. 

copy {filename] 

copy [msglis^ filename 

Copy messages to the file without marking the messages as saved. Otherwise 

equivalent to the save command. 

Copy [msglis^ Save the specified messages in a file whose name is derived from the author of 
the message to be saved, without marking the messages as saved. Otherwise 
equivalent to the Save command. 

delete [msglis^ Delete messages from the mailbox. If "autoprint" is set, the next message after 
the last one deleted is printed (see ENVIRONMENT VARIABLES). 

discard [header-field...] 

ignore [header-field...] 

Suppresses printing of the specified header fields when displaying messages on 
the screen. Examples of header fields to ignore are "status" and "cc." The fields 
are included when the message is saved. The Print and Type commands over- 
ride this command. 

dp [msglist] 

dt [msglist] Delete the specified messages from the mailbox and print the next message after 

the last one deleted. Roughly equivalent to a delete command followed by a 

print command. 

echo string... Echo the given strings (like echo{l)). 

edit [msglis^ Edit the given messages. The messages are placed in a temporary file and the 
"EDITOR" variable is used to get the name of the editor (see ENVIRONMENT 
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VARIABLES). Default editor is ed(l). 

exit 

xit Ebcit from mailx, without changing the mailbox. No messages are saved in the 

mbox (see also quit). 

file \filename] 
folder Ifilename] 

Quit from the cmrent file of messages and read in the specified file. Several spe- 
cial characters are recognized when used as file names, with the following substi- 
tutions: 

% the current mailbox. 
%user 

the mailbox for user. 
# the previous file. 
& the current mbox. 
Default file is the current mailbox. 

folders Print the names of the files in the directory set by the "folder" variable (see 

ENVIRONMENT VARIABLES). 

foUowup [meaaage] 

Respond to a message, recording the response in a file whose name is derived 
from the author of the message. Overrides the "record" variable, if set. See also 
the Followup, Save, and Copy commands and "outfolder" (ENVIRONMENT 
VARIABLES). 

Followup [magliat] 

Respond to the first message in the magliat, sending the message to the author of 
each message in the magliat. The subject line is taken from the first message and 
the response is recorded in a file whose name is derived from the author of the 
first message. See also the followup. Save, and Copy commands and "outfolder" 
(ENVIRONMENT VARIABLES). 

from [magliat] Prints the header summary for the specified messages. 

group aliaa name... 
alias aliaa name... 

Declare an alias for the given names. The names will be substituted when aliaa 

is used as a recipient. Useful in the .mailrc file. 

headers [meaaage] 

Prints the page of headers which includes the message specified. The "screen" 
variable sets the number of headers per page (see ENVIRONMENT VARIABLES). 
See also the z conunand. 

help Prints a smnmary of commands. 

hold [magliat] 
preserve [maglia^ 

Holds the specified messages in the mailbox. 
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If sir 

mail-commands 
else 

mail-commandB 
endif Conditional execution, where s will execute following mail-commands, up to an 

else or endif, if the program is in send mode, and r causes the mail-commands to 
be executed only in receive mode. Useful in the .mailrc file. 

ignore header-field,.. 

discard header-field... 

Suppresses printing of the specified header fields when displaying messages on 
the screen. Examples of header fields to ignore are "status" and "cc." All fields 
are included when the message is saved. The Print and Type commands over- 
ride this command. 

list Prints all commands available. No explanation is given. 

mail name... Mail a message to the specified users. 

mbox [msglis^ Arrange for the given messages to end up in the standard mbox save file when 
maih termmates normally. See "MBOX" (ENVIRONMENT VARIABLES) for a 
description of this file. See also the exit and quit commands. 

next [messag^ Go to next message matching message. A msglist may be specified, but in this 
case the first valid message in the list is the only one used. This is useful for 
jumping to the next message from a specific user, since the name would be taken 
as a command in the absence of a real conunand. See the discussion of msglists 
above for a description of possible message specifications. 

pipe [msglis^ [commant^ 

I [msglist][command^ 

Pipe the message through the given command. The message is treated as if it 
were read. If no arguments are given, the current message is piped through the 
command specified by the value of the "cmd" variable. If the "page" variable is 
set, a form feed character is inserted after each message (see ENVIRONMENT 
VARIABLES). 

preserve [msglist] 

hold [msglist] Preserve the specified messages in the mailbox. 



Print [ms 

Type [msglist] Print the specified messages on the screen, including all header fields. Overrides 
suppression of fields by the ignore command. 

print [msglist] 

type [msglist] Print the specified messages. If "crt" is set, the messages longer than the 
number of lines specified by the "crt" variable are paged through the command 
specified by the "PAGER" variable. The default command is pg{l) (see 
ENVIRONMENT VARIABLES). 

quit Exit from mailx, storing messages that were read in mbox and unread messages 

in the mailbox. Messages that have been e3q)licitly saved in a file are deleted. 
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Reply [msgliat] 

Respond [msglist] 

Send a response to the author of each message in the magliat. The subject line is 
taken from the first message. If "record" is set to a file name, the response is 
saved at the end of that file (see ENVIRONMENT VARIABLES). 

reply [message] 

respond [message] 

Reply to the specified message, including all other recipients of the message. If 
"record" is set to a file name, the response is saved at the end of that file (see 
ENVIRONMENT VARIABLES). 

Save [msglist] Save the specified messages in a file whose name is derived from the author of 
the first message. The name of the file is taken to be the author's name with all 
network addressing stripped off. See also the Copy, foUowup, and FoUowup 
conunands and "outfolder" (see ENVIRONMENT VAIUABLES). 

save [filename] 

save [msglist] filename 

Save the specified messages in the given file. The file is created if it does not 
exist. The message is deleted from the mailbox when mailx terminates unless 
"keepsave" is set (see also ENVIRONMENT VARIABLES and the exit and quit 
commands). 

set 

set name 

set name=string 

set name=number 

Define a variable called name. The variable may be given a null, string, or 
numeric value. Set by itself prints all defined variables and their values. See 
ENVIRONMENT VARIABLES for detailed descriptions of the mailx variables. 

shell Invoke an interactive shell (see also "SHELL" (ENVIRONMENT VARIABLES)). 

size [msglist] Print the size in characters of the specified messages. 

soiu-ce filename Read commands from the given file and return to command mode. 

top [msglist] Print the top few lines of the specified messages. If the "toplines" variable is set, 
it is taken as the number of lines to print (see ENVIRONMENT VARIABLES). 
The default is 5. 

touch [msy/wf] Touch the specified messages. If any message in msglist is not specifically saved 
in a file, it will be placed in the mbox upon normal termination. See exit and 
quit. 

Type [msglist] 

Print [msglist] Print the specified messages on the screen, including all header fields. Overrides 
suppression of fields by the ignore command. 

type [msglist] 

print [msglist] Print the specified messages. If "crt" is set, the messages longer than the 
number of lines specified by the "crt" variable are paged through the command 
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specified by the "PAGER" variable. The default conunand is pa(l) (see 
ENVIRONMENT VARIABLES). 

undelete [msglist] 

Restore the specified deleted messages. Will only restore messages deleted in the 
current mail session. If "autoprint" is set, the last message of those restored is 
printed (see ENVIRONMENT VARIABLES). 

unset name... Causes the specified variables to be erased. If the variable was imported from 
the execution enviromuent (i.e., a shell variable) then it cannot be erased. 

version Prints the current version and release date. 

visual [msglist] Edit the given messages with a screen editor. The messages are placed in a tem- 
porary file and the "VISUAL" variable is used to get the name of the editor (see 
ENVIRONMENT VARIABLES). 

write [msglia^ filename 

Write the given messages on the specified file, minus the header and truling 
blank line. Otherwise equivalent to the save command. 

xit 

exit Ebdt from maUx, without changing the mailbox. No messages are saved in the 

mbox (see also quit). 

z[+|-] Scroll the header display forward or backward one screen-full. The number of 

headers displayed is set by the "screen" variable (see ENVIRONMENT VARI- 
ABLES). 

TILDE ESCAPES 

The following commands may be entered only fi"om input mode, by beginning a line with the tilde 
escape character (~). See "escape" (ENVIRONMENT VARIABLES) for changing this special char- 
acter. 

~lcommand EJscape to the shell. 

Simulate end of file (terminate message input). 

'•.mail-command 
~ mail-command 

Perform the command-level request. Valid only when sending a message while 

reading mail. 

~? Print a summary of tilde escapes. 

~A Insert the autograph string "Sign" into the message (see ENVIRONMENT VARI- 

ABLES). 

~a Insert the autograph string "sign" into the message (see ENVIRONMENT VARI- 

ABLES). 

~b name ... Add the names to the blind carbon copy (Bcc) list. 
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'c name ... Add the names to the carbon copy (Co) list. 

"d Read in the dead.leUer file. See "DEAD" (under ENVIRONMENT VARIABLES) 

for a description of this file. 

~e Invoke the editor on the partial message. See also "EDITOR" (ENVIRONMENT 

VARIABLES). 

~f [msglist] Forward the specified messages. The messages are inserted into the message, 

without alteration. 

~h Prompt for Subject line and To, Cc, and Bcc lists. If the field is displayed with 

an initial value, it may be edited as if you had just typed it. 

~i string Insert the value of the named variable into the text of the message. For exam- 

ple, ~A is equivalent to '~i Sign.' 

~m [msglist] Insert the specified messages into the letter, shifting the new text to the right 
one tab stop. Valid only when sending a message while reading mail. 



Print the message being entered. 

Quit from input mode by simulating an interrupt. If the body of the message is 
not null, the partial message is saved in dead.letter. See "DEAD" (imder 
ENVIRONMENT VARIABLES) for a description of this file. 



"r filename 
~< filename 
~< Icommand Read in the specified file. If the argument begins with an exclamation point (!), 

the rest of the string is taken as an arbitrary shell command and is executed, 

with the standard output inserted into the message. 



'b string ... 
~t name ... 



'w filename 



Set the subject line to string. 

Add the given names to the To list. 

Invoke a preferred screen editor on the partial message. See also "VISUAL" 
(ENVIRONMENT VARIABLES). 

Write the partial message onto the given file, without the header. 

Exit as with ~q except the message is not saved in dead.letter. 



~\ command Pipe the body of the message through the given command. If the command 
returns a successful exit status, the output of the command replaces the message. 
ENVIRONMENT VARIABLES 

The following axe environment variables taken from the execution environment and are not alter- 
able within mailx. 



HOME directory 



The user's base of operations. 
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MAELRC filename 

The name of the start-up file. Default is $HOME/.mailrc. 

The following variables are internal matte variables. They may be imported from the execution 
environment or set via the set command at any time. The unset command may be used to erase 
variables. 

allnet All network names whose last component (login name) match are treated as 

identical. This causes the msglist message 8i)ecifications to behave similarly. 
Default is noallnet. See also the alternates command and the "metoo" variable. 

append Upon termination, append messages to the end of the mbox file instead of 

prepending them. Default is noappend. 

askcc Prompt for the Cc list after message is entered. Default is noaskcc. 

asksub Prompt for subject if it is not specified on the command line with the -s option. 

Enabled by default. 

autoprint Enable automatic printing of messages after delete and undelete commands. 

Default is noautoprint. 

bang Enable the special-casing of exclamation points (!) in shell escape command lines 

as in trt(l). Default is nobang. 

cmd = command 

Set the default command for the pipe command. No default value. 

cony = conversion 

Convert uucp addresses to the specified address style. The only valid conversion 
now is internet^ which requires a mail delivery program conforming to the 
RFC822 standard for electronic mail addressing. Conversion is disabled by 
default. See also "sendmail" and the -U command line option. 

crt = number Pipe messages having more than number lines through the command specified by 
the value of the "PAGER" variable (pff(l) by default). Disabled by default. 

DEAD = filename 

The neune of the file in which to save partial letters in case of untimely interrupt 
or delivery errors. Default is $HOME/dead.letter. 

debug Enable verbose diagnostics for debugging. Messages are not delivered. Default is 

nodebug. 

dot Take a period on a line by itself during input from a terminal as end-of-file. 

Default is nodot. 

EDITOR = command 

The command to run when the edit or ~e command is used. Default is ed(l). 

escape = c Substitute c for the ~ escape character. 
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folder = directory 

The directory for saving standard nudl files. User specified file names beginning 
with a plus (+) are expanded by preceding the file name with this directory 
name to obtain the real file name. If directory does not start with a slash (/), 
$HOME is prepended to it. In order to use the plus (+) construct on a mailx 
command line, "folder" must be an exported sh environment variable. There is 
no default for the "folder" variable. See also "outfolder" below. 



header 



Equable printing of the header summary when entering mailx. Enabled by 
default. 



hold 



Preserve all messages that are read in the mailbox instead of putting them in the 
standard mbox save file. Default is nohold. 



ignore Ignore interrupts while entering messages. Handy for noisy dial-up lines. 

Default is noignore. 

ignoreeof Ignore end-of-file during message input. Input must be terminated by a period 

(.) on a line by itself or by the ~. command. Default is noignoreeof. See also 
"dot" above. 

keep When the mailbox is empty, tnmcate it to zero length instead of removing it. 

Disabled by default. 

keepsave Keep messages that have been saved in other files in the mailbox instead of delet- 

ing them. Default is nokeepsave. 

NfBOX = filename 

The name of the file to save messages which have been read. The xit command 
overrides this function, as does saving the message explicitly in another file. 
Default is $HOME/mbox. 



metoo 



If your login appears as a recipient, do not delete it from the list. Default is 
nometoo. 



LISTER = command 

The command (and options) to use when listing the contents of the "folder" 
directory. The default is /s(l). 

onehop When responding to a message that was originally sent to several recipients, the 

other recipient addresses are normally forced to be relative to the originating 
author's machine for the response. This flag disables alteration of the recipients' 
addresses, improving efficiency in a network where all machines can send directly 
to all other machines (i.e., one hop away). 

outfolder Causes the files used to record outgoing messages to be located in the directory 

specified by the "folder" variable imless the pathname is absolute. Default is 
nooutfolder. See "folder" above and the Save, Copy, foUowup, and Followup 
commands. 

page Used with the pipe command to insert a form feed after each message sent 

through the pipe. Default is nopage. 
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PAGER = command 

The command to use as a filter for paginating output. This can also be used to 
specify the options to be used. Default is pff(l). 

prompt = string 

Set the command mode prompt to string. Default is "? ". 

quiet Refrain from printing the opening message and version when entering maUx. 

Default is noquiet. 

record = filename 

Record all outgoing mail in filename. Disabled by default. See also "outfolder" 
above. 

save Enable saving of messages in dead.letter on interrupt or delivery error. See 

"DEAD" for a description of this file. Enabled by default. 

screen = number 

Sets the number of lines in a screen-full of headers for the headers command. 

sendmail = command 

Alternate command for delivering messages. Default is mail{\). 

sendwait Wait for backgroimd mailer to finish before returning. Default is nosendwalt. 

SHELL = command 

The name of a preferred command interpreter. Default is 3A(1). 

showto When displaying the header summary and the message is from you, print the 

recipient's name instead of the author's name. 

sign = string The variable inserted into the text of a message when the ~a (autograph) com- 
mand is given. No default (see also ~i (TILDE ESCAPES)). 

Sign = string The variable inserted into the text of a message when the ~A command is given. 
No default (see also ~i (TILDE ESCAPES)). 

toplines = number 

The number of lines of header to print with the top command. Default is 5. 

VISUAL = command 

The name of a preferred screen editor. Default is vi{\). 

FILES 

/usr/mail/* post office directory 

$HOME/.mailrc personal start-up file 

/usr/lib/mailx/mailx.help* help message files 

/usr/lib/mailx/maibc.rc global start-up file 

$HOME/mbox secondary storage file 

/tmp/R[emqsx]* temporary files 

SEE ALSO 

mail(l), pg(l), l8(l). 



Hewlett-Packard Company - 11 - Version B.l, October 1986 



MAILX(l) HP-UX MAILX(l) 



BUGS 

Where command is shown as valid, arguments are not always allowed. Experimentation is recom- 
mended. 

Internal variables imported from the execution environment cannot be unset. 

The full internet addressing is not frilly supported by mailx. The new standards need some time 
to settle down. 

Attempts to send a message having a line consisting only of a "." are treated as the end of the 
message by mail{l) (the standard mail delivery program). 



Hewlett-Packard Company - 12 - Version B.l, October 1986 



MAKE(l) HP-UX MAKE(l) 



NAME 

make - maintain, update, and regenerate groups of programs 

SYNOPSIS 

make [-f makefile] [-p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] [-t] [-d] [-q] [names] 

DESCRIPTION 

The following is a brief description of all options and some special names. Options can occur in 
any order. 

-f makefile Description file name. Makefile is assmned to be the name of a description file. 

A file name of - denotes the standard input. The contents of makefile override 
the built-in rules if they are present. Note that the space between -f and 
makefile must be present. 

-p Print out the complete set of macro definitions and target descriptions. 

-i Ignore error codes returned by invoked commands. This mode is also entered if 

the fake target name .IGNORE appears in the description file. 

-k When a command returns nonzero status, abandon work on the current entry, 

but continue on other branches that do not depend on that entry. 

-8 Silent mode. Do not print command lines before executing. This mode is also 

entered if the fake target name .SILENT appears in the description file. 

-r Do not use the built-in rules. 

-n No execute mode. Print commands, but do not execute them. Even lines begin- 

ning with an are printed. 

-b Compatibility mode for old (Version 7) makefiles . 

-e Environment variables override assignments within makefiles. 

-t Touch the target files (causing them to be up-to-date) rather than issue the 

usual commands. 

-d Debug mode. Print out detailed information on files and times examined. (This 

is intended for debugging the mtJse command itself.) 

-q Question. The make command returns a zero or non-zero status code depending 

on whether the target file is or is not up-to-date. 

The "built-in" dependency targets are: 

.DEFAULT If a file must be made but there are no explicit commands or relevant built-in 
rules, the commands associated with the name .DEFAULT are used if it exists. 

.PRECIOUS Dependents of this target will not be removed when QUIT or INTERRUPT are 
hit. 

.SILENT Same eflFect as the ^b option. 

.IGNORE Same effect as the -i option. 

Make executes commands in makefile to update one or more target names. Name is typically a 
program. If no -f option is present, makefile. Makefile, s.makefile, and s.Makefile are tried 
in order. If makefile is -, the standard input is taken. More than one -f makefile argmnent pair 
may appear. 

Make updates a target only if it depends on files that are newer than the target. All prerequisite 
files of a target are added recm^ively to the list of targets. Missing files are deemed to be out of 
date. 
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Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a 
blank-separated, non-null list of targets, followed by a colon (:), followed by a (possibly null) list 
of prerequisite files or dependencies. Text following a ; and all following lines that begin with a 
tab are shell conunands to be executed to update the target, see the Environment section below 
about SHELL. The first line that does not begin with a tab or # begins a new dependency or 
macro definition. Shell commands may be continued across lines with the <backsla8h><new- 
line> sequence. Everything printed by make (except the initial tab) is passed directly to the shell 
as is. Thus, 

echo a 
b 

will produce 

ab 

exactly the same as the shell would. 

Sharp (#) and new-line surround comments before the rules. Comments in the rules depend on 
the setting of the SHELL macro. 

The following makefile says that pgm depends on two files a.o and b.o, and that they in turn 
depend on their corresponding source files (a.c and b.c) and a common file incl.h: 

pgm: a.o b.o 

cc a.o b.o -o pgm 
a.o: incl.h a.c 

cc -c a.c 
b.o: incl.h b.c 

cc -c b.c 

Command lines are executed one at a time, each by its own shell. The first one or two characters 
in a command can be the following: -, @, -@, or @-. If @ is present, printing of the command is 
suppressed. If - is present, make ignores an error. A line is printed when it is executed unless the 
-8 option is present, or the entry .SILENT: is in makefile, or imless the initial character sequence 
contains a @. The -n option specifies printing without execution; however, if the command line 
has the string $(MAKE) in it, the line is always executed, see discussion below of the 
MAKEFLAGS macro under Environment. Note that this feature does not work if MAKE is 
enclosed in braces, as in ${MAKE}. The -t (touch) option updates the modified date of a file 
without executing any commands. 

Commands returning non-zero status normally terminate make. If the -i option is present, or the 
entry .IGNORE: appears in makefile, or the initial character sequence of the command contains -. 
the error is ignored. If the -k option is present, work is abandoned on the current entry, but con- 
tinues on other branches that do not depend on that entry. 

The -b option allows old makefiles (those written for the old version of make) to run without 
errors. The difference between the old version of make and this version is that this version 
requires all dependency lines to have a (possibly null or implicit) command associated with them. 
The previous version of make assumed, if no command was specified explicitly, that the command 
was null. 

INTERRUPT and QUIT cause the target to be deleted unless the target depends on the special 
name .PRECIOUS. 

Environment 

The environment is read by make. All variables are assumed to be macro definitions and pro- 
cessed as such. The environment variables are processed before any mcJcefile and after the inter- 
nal rules; thus, macro assignments in a makefile override environment variables. The -e option 
causes the environment to override the macro assignments in a makefile. 
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The MAKEFLAGS environment variable is processed by make as containing any legal input 
option (except -f, — p, and -d) defined for the conunand line. Further, upon invocation, make 
"invents" the variable if it is not in the environment, puts the current options into it, and passes 
it on to invocations of conunands. Thus, MAKEFLAGS always contains the ciurent input 
options. This proves very useful for "super-makes". In fact, as noted above, when the -n option 
is used, the command )(MAKE) is executed anyway; hence, one can perform a make -n recur- 
sively on a whole software system to see what would have been executed. This is because the -n 
is put in MAKEFLAGS and passed to further invocations of $(MAKE). This is one way of 
debugging all of the makefiles for a software project without actually doing anything. 

Each of the commands in the rules is given to a shell to be executed. The shell that is used is 
determined by the SHELL environment variable, which is usually set to the shell with which the 
user logs in. To ensure the same shell is used each time a makefile is executed, the line: 

SHELL=/bin/8h 

should be put in the macro definition section of the makefile. 

Macros 

Entries of the form stringl = string2 are macro definitions. String2 is defined as all characters up 
to a comment character or an unescaped new-line. Subsequent appearances of %{8tringl[.substl= 
{artbst2]]) are replaced by string2. The parentheses are optional if a single character macro name 
is used and there is no substitute sequence. The optional ■.aubstl=8ubat2 is a substitute sequence. 
If it is specified, all non-overlapping occurrences of substl in the named macro are replaced by 
subst2. Strmgs (for the purposes of this type of substitution) are delimited by blanks, tabs, new- 
line chsiracters, and beginnings of lines. An example of the use of the substitute sequence is 
shown under Libraries. 

Internal Macros 

There are five internally maintained macros that are useful for writing rules for building targets. 

$* The macro $* stands for the file name part of the current dependent with the 

suffix deleted. It is evaluated only for inference rules. 

$© The $@ macro stands for the full target name of the current target. It is 

evaluated only for explicitly named dependencies. 

$< The $< macro is only evaluated for inference rules or the .DEFAULT rule. It is 

the module that is out-of-date with respect to the target, i.e., the "manufac- 
tured" dependent file name. Thus, in the .c.o rule, the $< macro would evalu- 
ate to the .c file. An example for making optimized .o files from .c files is: 

.c.o: 

cc -c -O $*.€ 



cc -c -O $< 

$? The $? macro is evaluated when explicit rules from the makefile are evaluated. 

It is the list of prerequisites that are out of date with respect to the target; essen- 
tially, those modules that must be rebuilt. 

$% The $% macro is only evaluated when the target is an archive library member of 

the form lib(file.o). In this case, $@ evaluates to lib and $% evaluates to the 
library member file.o. 

Four of the five macros can have alternative forms. When an upper case D or F is appended to 
any of the four macros, the meaning is changed to "directory part" for D and "file part" for F. 
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Thus, $(@D) refers to the directory part of the string $®. If there is no directory part, ./ is gen- 
erated. The only macro excluded from this alternative form is $?. The reasons for this are debat- 
able. 

Suffixes 

Certain names (for instance, those ending with .o) have inferable prerequisites such as .c, .s, etc. 
If no update conmiands for such a file appear in makefile, and if an inferable prerequisite exists, 
that prerequisite is compiled to make the target. In this case, make has inference rules that allow 
buUding files from other files by examining the suffixes and determinmg an appropriate inference 
rule to use. The current default inference rules are: 

.c .c~ .sh .8h~ .CO .c~.o .c~.c .s.o .8~.o .y.o .y~.o .I.o .l~.o 
.y.c .y~.c .l.c .c.a .c~.a .8~.a .h~.h 

To print out the rules compiled into the make on any machine in a form suitable for recompila- 
tion, the following command is used (if using /bin/sh as a shell): 

make -fp - 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string that prinf/(3S) prints when handed a null 
string. 

A tilde in the above rules refers to an SCCS file, see scc8file{4). Thus, the rule .c~.o would 
transform an SCCS C source file into an object file (.o). Because the s. of the SCCS files is a 
prefix, it is incompatible with mate's suffix point-of-view. Hence, the tilde is a way of changing 
any file reference into an SCCS file reference. 

A rule with only one suffix, i.e., ".c:", is the definition of how to build x from i.e. In effect, the 
other suffix is null. This is useful for building targets from only one somrce file, e.g., shell pro- 
cedures, simple C programs. 

Additional suffixes are given as the dependency list for .SUFFIXES. Order is significant; the first 
possible name for which both a file and a rule exist is inferred as a prerequisite. 

The default list is: 

.SUFFIXES: .o .c .y .1 .s 

Here again, the above command for printing the internal rules will display the list of suffixes 
implemented on the ciurent machine. Multiple sufBx lists accmnulate; .SUFFIXES: with no 
dependencies clears the list of suffixes. 

Inference Rules 

The first example can be done more briefly: 

pgm: a.o b.o 

CO a.o b.o -o pgm 
a.o b.o: incl.h 

This is because make has a set of internal rules for building files. The user may add rules to this 
list by sunply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the inclusion of optional matter 
in any resulting commands. For example, CFLAGS, LFLAGS, and YFLAGS are used for com- 
piler options to cc(l), lex{l), and yacc{l), respectively. AgEiin, the previous method for examin- 
ing the current rules is recommended. 

The inference of prerequisites can be controlled. The rule to create a file with suffix .o from a file 
with suffix .0 is specified as an entry with .c.o: as the target and no dependents. Shell commands 
associated with the target define the rule for making a .o file from a .c file. Any target that has 
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no slashes in it and starts with a dot is identified as a rule and not a true target. 

Libraries 

If a target or dependency name contains parentheses, it is assumed to be an archive library, the 
string within parentheses referring to a member within the library. Thus lib(flle.o) and 
$(LIB)(flle.o) both refer to an archive library that contains file.o. (This assumes the LIB macro 
has been previously defined.) The expression $(LIB)(filel.o file2.o) is not legal. Rules pertain- 
ing to archive libraries have the form .XX.A where the XX is the sufBx from which the archive 
member is to be made. An imfortimate byproduct of the current implementation requires the XX 
to be diflFerent from the suffix of the archive member. Thus, one cannot have lib(flle.o) depend 
upon file.o explicitly. The most common use of the archive interface follows. Here, we assmne 
the source files are all C type source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

@ ©echo lib is now up-to-date 
.c.a: 

$(CC) -c $(CFLAGS) $< 

ar rv $@ $*.o 

rm -f $*.o 

In fact, the .c.a rule listed above is built into make and is imnecessary in this example. A more 
interesting, but more limited example of an archive library maintenance construction follows: 

lib: lib(fllel.o) lib(file2.o) lib(file3.o) 
$(CC) -c $(CFLAGS) $(?:.o=.c) 
ar rv lib $? 
rm $7 @ @echo lib is now up-to-date 

.c.a:; 

Here the substitution mode of the macro expansions is used. The $? list is defined to be the set 
of object file names (inside lib) whose C source files are out-of-date. The substitution mode 
translates the .o to .c. (Unfortimately, one cannot as yet transform to .c~; however, this may 
become possible in the future.) Note also, the disabling of the .c.a: rule, which would have 
created each object file, one by one. This particular construct speeds up archive library mainte- 
nance considerably. This type of construct becomes very cmnbersome if the archive library con- 
tains a mix of assembly programs and C programs. 

FILES 

[Mm]akefile and s.[Mm]akefile 

SEE ALSO 

cc(l), cd(l), lex(l), sh(l), yacc(l). 

WARNINGS 

Be wary of any file (such as an include file) whose access, modification, and last chemge times can- 
not be altered by the make-'mg process. For example, if a program depends on an include file that 
in turn depends on another include file, £ind if one or both of these files are out-of-date, make will 
try to update these files each time it is run, thus unnecessarily re-makang up-to-date files depen- 
dent on the include file. The solution is to manually update these files with the touch{l) com- 
mand before running make. (Note that it is generally a bad idea to include the touch{l) command 
in your makefile, because it can cause make to update a program that otherwise did not need to 
be updated.) 



BUGS 



Some commands rettun non-zero status inappropriately; use -i to overcome the difficulty. 
File names with the characters @ = : @ will not work. 
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Commands that are directly executed by the shell, notably cd{l), are ineffectual across new-lines 
in make. 

The syntax (lib(filel.o flle2.o BleS.o) is illegal. 

You cannot build lib(flle.o) from file.o. 

The macro $(a:.o=.c~) does not work. 

There is a limit of 2500 characters, including the terminating new-line, for expanded dependency 
lines. 

Mdee will not properly expand a macro within another macro when string substitution is involved. 

INTERNATIONAL SUPPORT 

8-bit data. 
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NAME 

makekey - generate encryption key 

SYNOPSIS 

/usr/Iib/makekey 

REMARKS 

The decrsrption facilities provided by this software are imder control by the United States Govern- 
ment and cannot be exported without special licenses. These capabilities can be sold only to 
domestic customers at this time. 

DESCRIPTION 

Makekey improves the usefulness of encryption schemes depending on a key by increasing the 
amoimt of time required to search the key space. It reads 10 bytes from its standard input, and 
writes 13 bytes on its standard output. The output depends on the input in a way intended to be 
difficult to compute (i.e., to require a substantial fraction of a second). 

The first eight input bytes (the input key) can be arbitrary ASCII characters. The last two (the 
salt) are best chosen from the set of digits, ., /, and upper- and lower-case letters. The salt char- 
acters are repeated as the first two characters of the output. The remaining 11 output characters 
are chosen from the same set as the salt and constitute the output key. 

The transformation performed is essentially the following: the salt is used to select one of 4,096 
cryptographic machines all based on the National Bureau of Standards DES algorithm, but broken 
in 4,096 different ways. Using the input key as key, a constant string is fed into the machine and 
recirculated a number of times. The 64 bits that come out are distributed into the 66 output key 
bits in the result. 

Makekey is intended for programs that perform encryption (e.g., ed{l) and crypt{l)). Usually, its 
input and output will be pipes. 

SEE ALSO 

crypt(l), ed(l), pa8swd(4). 
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NAME 

man - find manual information by keywords; print out the manual 

SYNOPSIS 

man -k keyword ... 

man -f file ... 

man [ - ] [ section ] title ... 

DESCRIPTION 

Man is a program which gives information from the programmer's manual. It can be asked to 
form one line descriptions of commands specified by name, or for all commands whose description 
contains any of a set of keywords. It can also provide online access to the sections of the printed 
manual. 

When given the option -k and a set of keywords, man prints out a one line synopsis of each 
manual section whose listing in the table of contents contains that keyword. 

When given the option -f and a list of file names, man attempts to locate manual sections related 
to those files, printing out the table of contents lines for those sections. 

When neither -k nor -f is specified, man formats a specified set of manual pages. If a section 
specifier is given, man looks in that section of the manual for the given titles. Section is an arable 
section munber, e.g. 3, which may be followed by a single letter classifier, e.g. Ig indicating a 
graphics program in section 1. If section is omitted, man searches all sections of the manual, giv- 
ing preference to commands over subroutines in system libraries, and printing the first section it 
finds, if any. Each title is truncated to at most 11 characters to assure that there will be room for 
the section. The files in the /usr/man directories also truncate the title portion of the file name 
at 11 characters to assure room for the suflBx in the 14 character file name. 

If the standard output is a teletjrpe, or if the flag - is given, man pipes its output through more 
(1), with the -« option, to stop after each page. 

Man searches in three directories for the target file. First man searches in /usr/man, then in 
/usr/contrib/man, and finally in /usr /local/man. Within each of these directories, first man 
searches in the cat* subdirectory, and then in the man* subdirectory. If, on first access to the 
cat* subdirectory, the target file is not present, man retrieves it from the man* subdirectory, for- 
mats it, and (if cat* exists) installs it in cat*. If only the cat* subdirectory is present and/or nroflF 
is not installed, only those pages which have been preformatted are displayable. 

FILES 

/usr/contrib/man/cat * / * 
/usr/contrib/man/man*/* 
/usr /local/man/cat* /* 
/usr/local/man/man*/* 
/usr /man/cat*/* 
/usr /man/man* / * 

SEE ALSO 

catmaa(lM), more(l), rmnl(l), ul(l), whereis(l). 

BUGS 

The manual is supposed to be reproducible either on the phototypesetter or on a tyi)ewriter. 
However, on a typewriter some information is necessarily lost. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

mau — Snd maiiUa! infoniiatioji by keywords; print out the maaual 

SYNOPSIS 

man -k keyword ... 

man -f file ... 

man [ - ] [ section ] title ... 

DESCRIPTION 

Man is a program which gives information from the programmer's manual. It can be asked to 
form one line descriptions of commands specified by name, or for all commands whose description 
contains any of a set of keywords. It can also provide online access to the sections of the printed 
manual. 

When given the option -k and a set of keywords, man prints out a one line synopsis of each 
manual section whose listing in the table of contents contains that keyword. 

When given the option -f and a list of file names, man attempts to locate manual sections related 
to those files, printing out the table of contents lines for those sections. 

When neither -k nor -f is specified, man formats a specified set of manual pages. If a section 
specifier is given, man looks in that section of the manual for the given titles. Section is an arable 
section niunber, e.g. 3, which may be followed by a single letter classifier, e.g. Ig indicating a 
graphics program in section 1. If section is omitted, man searches all sections of the manual, giv- 
ing preference to commands over subroutines in system libraries, and printing the first section it 
finds, if any. Each title is truncated to at most 11 characters to assm-e that there will be room for 
the section. The files in the /usr/inan directories also truncate the title portion of the file name 
at 11 characters to assiu-e room for the suffix in the 14 character file name. 

If the standard output is a teletype, or if the flag - is given, man pipes its output through more 
(1), with the -8 option, to stop after each page. 

Man searches in three directories for the target file. First man searches in /usr/man, then in 
/usr/contrib/man, and finally in /usr /local/man. Within each of these directories, man 
searches in the cat*.Z subdirectory, the man^.Z subdirectory, the cat* subdirectory, and the man* 
subdirectory to find the most recent version of the manual entry. If the man* or man*.Z file is 
most recent, or if the file is not present in cat* or cat*.Z, man retrieves it from the man* or 
man*.Z subdirectory and formats it. If the cat*.Z subdirectory exists, the formatted version is 
compressed and installed in cat*.Z. Otherwise, if the cat* subdirectory exists, the formatted ver- 
sion is installed in cat*. The files in man*.Z and cat*.Z are in compressed form and must be 
uncompressed before they may be displayed. If only the cat* or cat*.Z subdirectory is present 
and/or nroff is not installed, only those pages which have been preformatted are displayable. 

FILES 

/usr/man/cat*[.Z]/* 

/usr/man/man*[.Z]/* 

/usr/contrib/man/cat*[.Z]/* 

/usr/contrib/man/man* f.Z]/* 

/usr/locaI/man/cat*[.Z]/* 

/usr/local/man/man*[.Z]/* 

SEE ALSO 

catman(lM), more(l), rmnl(l), ul(l), whereis(l), compress(l). 

BUGS 

The manual is supposed to be reproducible either on a phototypesetter or on a typewriter. How- 
ever, on a typewriter some information is necessarily lost. 
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INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

mediainit - initialize hard disk, flexible disk, or cartridge tape media 

SYNOPSIS 

mediainit [-vr] [-f fint—optn] [-i interieave] pathname 

DESCRIPTION 

Mediainit initializes mass storage media by formatting the media, writing and reading test pat- 
terns to verify media integrity, then sparing any defective blocks foimd. This process prepares the 
disk or tape for error-free operation. Initialization destroys all existing user data in the area being 
initialized. 

The following command options are recognized. They can be specified in any order, but all must 
precede the pathname. Options without parameters can be listed individually or grouped 
together. Options with parameters must be listed individually, but white space between the 
option and its parameter is discretionary. 

-V Normally, mediainit provides only fatal error messages, and they are directed to 

diagnostic output (stderr). The -v (verbose) option sends device-specific infor- 
mation related to low-level operation of mediainit to standard output (stdout). 
This option is most useful to trained service personnel because it usually requires 
detailed knowledge of device operation before the information can be interpreted 
correctly. 

-r The -r (re-certify) option forces a complete tape certification whether or not the 

tape has been certified previously. All record of any previously spared blocks is 
discarded, so any bad blocks will have to be rediscovered. This option should be 
used only if: (a) it is suspected that numerous blocks on the tape have been 
spared which should not have been, or (b) it is necessary to destroy (overwrite) 
all previous data on the tape. 

-f fmt—optn The format option is a device-specific number in the range through 239. It is 
intended solely for use with certain SS/80 devices that support multiple media 
formats (independent from interleave factor). For example, certain microfloppy 
drives support 256-, 512-, and 1024-byte sectors. Mediainit passes any supplied 
format option directly through to the device. The device then either accepts the 
format option if it is supported or rejects it if it is not supported. Refer to dev- 
ice operating manuals for additional information. The default format option is 0. 

-i interleave The interleave factor, interleave, refers to the relationship between sequential 
logical records and sequential physical records. It defines the nmnber of physical 
records on the media that lie between the beginning points of two consecutively 
numbered logical records. The choice of interleave factor can have a substantial 
impact on disk performance. For CS/80 and SS/80 drives, consult the appropri- 
ate device operating manual for details. For Amigo drives, see HARDWARE 
DEPENDENCIES 

Pathname Pathname is the path name to the character (raw) device special file associated 

with the device unit or volume that is to be initialized. Mediainit aborts if you 
lack either read or write permission to the device special file, or if the device is 
currently open for any other process. This prevents accidental initialization of 
the root device or any mounted volume. See HARDWARE DEPENDENCIES for 
additional Series 800 requirements. Mediainit locks the unit or volume being ini- 
tialized so that no other processes can access it. 

When a given CS/80 or SS/80 device contains multiple imits or a given imit contains multiple 
volumes as defined by the drive controller, any available unit or volume associated with that con- 
troller can be initialized, independent of other imits and volumes that shsire the same controller. 
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Thiis, you can initialize one unit or volmne to any format or interleave factor without affecting 
formats or data on companion units or volumes. However, be aware that the entire unit or 
volmne (as defined by the drive controller) is initialized without considering the possibility that it 
may be subdivided into smaller structtires by the the operating software. When such structm-es 
exist, imexpected loss of data is possible. 

Mediainit dominates controller resources and limits access by competing processes to other imits 
or volumes sharing the came controller. If other simultaneous processes need access to the same 
controller, some access degradation can be expected until initialization is complete; especially if 
you are initializing a tape cartridge in a drive that shares the root disk controller. See Series 800 
HARDWARE DEPENDENCIES for additional Series 800 information. 

In general, mediainit attempts to carefully check any -f (format option) or -i (interleave options) 
supplied, and aborts if an option is out of range or inappropriate for the media being initialized. 
Specifying an interleave factor or format option value of has the same effect as not specifying 
the option at all. 

For disks that support interleave factors, the acceptable range is usually 1 (no interleave) through 
N-1, where N is the niraiber of sectors per track. With SS/80 hard disks, the optimiun interleave 
factor is usually determined by the speed (normal or high) of the HP-IB interface card used and 
whether DMA is present in the system. The optimum interleave factor for SS/80 flexible disk 
drives is usually a constant (often 2), and is independent of the type of HP-IB interface used. 
The optimum interleave factor for CS/80 disks is usually 1 and is also usually not related to the 
type of HP-IB interface being used. In any case, refer to the appropriate device operating manual 
for recommended values. 

If a disk being initialized requires an interleave factor but none is specified, mediainit provides an 
appropriate, though not necessarily optimum default. For CS/80 and SS/80 disks, mediainit uses 
whatever the device reports as its current interleave factor. SS/80 floppy drives report their 
TninimuTTi (usually best) interleave factor, if the currently installed media is imformatted. 

When a given device supports format options, the allowable range of interleave factors may be 
related to the specified format option. In such instances, mediainit cannot check the interleave fac- 
tor if one is specified. 

RETURNS 

Mediainit retiums a value of upon successful completion, a value of 1 if there was a device- 
related error, or a value of 2 if there was a syntax-related error. 

Appropriate error messages are printed out to stderr during the execution of mediainit. 

EXAMPLES 

The following example formats an HP 9122 SS/80 3-1/2" flexible disk with an interleave factor of 
2, 1024-byte sectors, double-sided HP format: 

mediainit -i 2 -f 3 /dev/r9122 

HARDWARE DEPENDENCIES 

Series 200, Series 300 

Series 200, and Series 300 systems support various Amigo disk drives. Acceptable interleave 
factors for Amigo devices are as follows: 
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Device 


RanKe 


Default 


HP 9895 SS/DS 


1-29 


2 


HP8290X 


1-15 


3 


HP 9121 


1-15 


2 


HP 9133V 


na 


9 


HP9133XV 


na 


9 


HP9134XV 


na 


9 



Series 800 

Pathname must be a device special file whose minor niunber for the section of the device 
being initialized has the diagnostic bit set (the diagnostic bit is the most significant bit in 
the minor number). 

For a device that contains multiple imits on a single controller or multiple sections within a 
unit, each unit or section can be initialized independently from any other unit or section. It 
should be noted, however, that mediainit requires that there be no other processes accessing 
the unit or section before initialization begins, regardless of which unit or section is being 
initialized. If there are accesses currently in progress, mediainit aborts. During the initiali- 
zation process, open (2) rejects all other accesses to the device being initialized, producing 
the error [EACCES]. 

WARNINGS 

Aborting mediainit is likely to leave the medium in a corrupt state, even if it was previously ini- 
tialized. To recover, the initialization must be restarted. 

AUTHOR 

Mediainit was developed by HP. 

SEE ALSO 

mkfs(lM), newfs(lM), lifinit(l). 



NOTES 



Most types of mass storage media must be initialized before they can be used. HP hard disks, 
flexible disks, and cartridge tapes require some form of initialization, but 9-track tapes do not. 
Initialization usually involves formatting the media, writing and reading test patterns, then spar- 
ing any defective blocks. Depending upon the media and device type, none, some, or all of the ini- 
tialization process may have been performed at the factory. Mediainit completes whatever steps 
are appropriate to prepare the media for error-fr«e operation. 

Most HP hard disks are formatted and exhaustively tested at the factory by use of a process more 
thorough but also more time-consmning than appropriate for mediainit. However, mediainit is still 
valuable for ensiuring the integrity of the media after factory shipment, formatting with the 
correct interleave factor, and sparing any blocks which may have become defective since original 
factory testing was performed. 

HP flexible disks are not usually formatted prior to shipment, so they must imdergo the entire ini- 
tialization process before they can be used. 

All HP CS/80 cartridge tapes are certified and formatted prior to shipment from the factory. 
When a tape is certified, it is throroughly tested and defective blocks are spared at that time. 
While Mediainit usueilly certifies a tape only if it has not been certified previously. If the tape has 
been previously certified and spared, mediainit usually reorganizes the tape's spare block table, 
ret^ning any previous spares, but optimizing their assignment for maximum performance under 
sequential access. Reorganizing the spare block table takes only a few seconds, whereas complete 
certification takes about a half-hour for 150-foot tapes, and over an hour for 600-foot tapes. 

HP CS/80 cartridge tape drives have a feature called "auto-sparing", where if under normal usage 
the drive has trouble reading a block, the drive logs the fact then automatically spares out that 
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block the next time data is written to it. Thtis, as a tape is used, any marginal blocks that were 
not spared during certification are spared automatically if they cause problems. This sparing is 
automatic within the device, and is totally independent of Mediainit. 

Reorganization of a tape's spare block table technically renders any existing data imdefined, but 
the data is not usuadly destroyed by overwriting. To ensiu-e that old tape data is destroyed (use- 
ful for security reasons among other things), complete tape re-certification can forced with the -r 
option. 

Some applications may require that a file system be placed on the media before use. Mediainit 
does not create a file system; it only prepares media for writing and reading. Other utilities such 
as newfs{lM), lifinit{l) or mkfs{lM). must be invoked after nmning mediainit, if such a file sys- 
tem is required. 



Hewlett-Packard Company - 4 - Version B.l, October 1986 



MESG(l) HP-UX MESG(l) 



NAME 

mesg - permit or deny messages to terminal 

SYNOPSIS 

mesg [ n ] [ y ] 

DESCRIPTION 

Mesg with argument n forbids messages via uurite{l) by revoking non-user write permission on the 
user's terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the 
current state without changing it. 

FILES 

/dev/tty* 
SEE ALSO 

write(l). 

DIAGNOSTICS 

Exit status is if messages are receivable, 1 if not, 2 on error. 
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NAME 

mkdir - make a directory 

SYNOPSIS 

mkdir dimame ... 

DESCRIPTION 

Mkdir creates specified directories in mode 777 (possibly altered by umaaJt(l)). Standard entries, 
., for the directory itself, and .., for its parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rm(l), sh(l), imiask(l). 

DIAGNOSTICS 

Mkdir returns exit code if all directories were successfully made; otherwise, it prints a diagnostic 
and returns non-zero. 

INTERNATIONAL SUPPORT 

8-bit filenames, messages. 
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NAME 

SYNOPSIS 
mksf 

mksf 

mksf 

mksf 

mksf 

mksf 

mksf 

mksf 



mksf - make a special file 

f devfile] -d discO [-1 lu] [-u imit] [-s section] [-c] [-t] [path...] 

-f devfile] -d gpioO [-1 lu] [path...] 

f devfile] -d instrO [-1 lu] [-a address] [path...] 

f devfile] -d IprO [-1 lu] [-c] [-n] [-r] [-t] [path...] 

f devfile] -d muxO [-1 lu] [-p port] [-hl-i|-o] [-c] [path...] 

f devfile] -d muxl [-1 lu] [path...] 

f devfile] -d pseudo [-m minor] path... 

-f devfile] -d tapeO [-1 lu] [-b bpi] [-8 section] [-al-u] [-c] [-n] [-t] [-w] [path...] 



mksf 



■f devfile] -d tapel [-1 lu] [-b bpi] [-8 section] [-a|-u] [-c] [-n] [-t] [-w] [path...] 



DESCRIPTION 

JWfcr/ makes a special file. The -f option specifies devfile, which is a file that describes drivers and 
pseudo-drivers. This file is generated by uxgen{l). If the -f option is not present, then the file 
/etc/device8 is used. The -d option specifies the driver name. Other options depend on the 
driver name. 

Mksf scans devfile to determine the major number of the driver. While scanning devfile, the lu 
(logical imit) is checked for vaUdity. Hence, a special file may not be created for a device which is 
not in the devfile. 

Some of the common argtmients used are: 

-1 lu is the logical unit number of a device, lu is assigned by uxgen{l). 

-t transparent mode (normally used by diagnostics). 

path name of the special file. Path is created in the current du-ectory. If the file 

already exists, it will be removed and then created. Most drivers have a default 
name for path. 

Each driver has a specific set of arguments which are shown in the following sections. 



DISCO 



-c This argument must be present if the unit is a cartridge tape. 

-u unit The cs80 unit niunber (eg. unit - disc, unit 1 - tape). 

-r Raw, use character major not block major. 

-8 section The section niunber. 

path The default path name depends on the arguments -r -c: 

rct/c<lu>d<imit>s<section>, if -r and -c 
rdsk/c<lu>d<unit>s<section>, if -r and not -c 
ct/c<lu>d<imit>s<section>, if not -r and -c 
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MKSF(l) 



Series 800 Only 



GPIOO 



path 



dsk/c<lu>d<unit>s<section>, if not -r and not -c 
The default path name is gpio<lu>. 



INSTRO 

-a address 


The hpib instrument address (0-31). 


path 


The default path name is hpib/<lu>a<address> 


LPRO 

-C 


Caps. Uppercase all output. 


-n 


No form-feed. 


-r 


Raw. 


path 


default path name is lpr<lu> or rlpr<lu> (if -r). 


MUXO 

-c 


CCITT. 


-h 


Hardwired (direct connect). 


-i 


Callin. 


-o 


Callout. 


-p port 


Multiplexor port nmnber (0-5). 


path 


The default path name is tty<lu>p<port> 


MUXl 

path 


Default path name is mux<lu>. 


TAPEO/TAPEl 
-a 


Att style rewind/close. 


-b bpi 


Bits per inch. Values of bpi are 800, 1600, 6250. 


-c 


RTE compatible close. 


-n 


No rewind on close. 



UC Berkeley style rewind/close. 



.rm]B 
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NAME 

mkstr - extract error messages from C source into a file 

SYNOPSIS 

mkstr [ - ] messagefile prefix file ... 

DESCRIPTION 

Mkstr examines a C program and creates a file containing error message strings used by the pro- 
gram. Programs with many error diagnostics can be made much smaller by referring to places in 
the file, and reduce system overhead in running the program. 

Mkstr processes each of the specified files, placing a revised version of each in a file whose name 
consists of the specified prefix concatenated in front of the original name. A typical usage of 
mkstr would be 

mkstr mystrings xx *.c 

This command would cause all the error messages from the C source files in the current directory 
to be placed in the file mystrings and revised copies of the source for these files to be placed in 
files whose names are prefitxed with xx. 

When processing the error messages in the source for transfer to the message file, mkstr searches 
for the string error(" in the input file. Each time it is encountered, the C string starting after 
the leading quote is placed in the message file, followed by a null character and a new-line charac- 
ter. The null character terminates the message so that it can be easily used when retrieved, and 
the new-line character makes it possible to conveniently cat the error message file to review its 
contents. 

The modified copy of the input file is identical to the original, except that each occurrence of any 
string that was moved to the error message file is replaced by an offset pointer usable by Iseek to 
retrieve the message. 

If the conunand line includes the optionsil -, extracted error messages are placed at the end of the 
specified message file instead of overwriting it. This enables you to process individual files that 
are part of larger programs that have been previously processed by mkstr without reprocessing all 
the files. 

All functions used by the original program whose names end in "error" that also can take a con- 
stant string as their first argmnent should be rewritten so that they search for the string in the 
error message file. 

For example, a program based on the previous example usage would resemble the following: 



^include <stdio.h> 
#include <sys/types.h> 
#include <fcntl.h> 

char errfile[] = "mystrings"; 

error(oiFset, a2, a3, a4) 
int offset, al, a2, a3; 

{ 

char msg[256]; 
static int fd = -1; 

if (fd < 0) { 

fd = open(errfile, 0_RDONLY); 
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if (fd < 0) { 

perror(errfile); 

exit(l); 
} 
} 

if (l8eek(fd, (oflL_t) offset, 0) I I read(fd, msg, 256) <= 0) { 
printfC? Can't find error message in %s:\n", errfile); 
perror(errfile); 
exit(l); 

} 

printf(msg, al, a2, a3); 
} 
SEE ALSO 

lseek(2), perror(3C), xstr(l). 

BUGS 

Strinp in calls to functions whose names end in 'error', notably perror(3C), may be replaced with 
offsets by mkstr. 

Calls to error functions whose first argument is not a string constant are left immodified without 
warning. 
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NAME 

mm, osdd - print/check docimients formatted with the MM macros 

SYNOPSIS 

mm [ options ] [ files ] 

osdd [ options ] [ files ] 

DESCRIPTION 

Mm can be used to type out dociunents using nroff{l) and the MM text-formatting macro pack- 
age. It has options to specify preprocessing by tbl{l) and/or neqn{l) and postprocessing by vari- 
ous terminal-oriented output filters. The proper pipelines and the required arguments and flags 
for nroff{l) and MM are generated, depending on the options selected. 

Options for mm are given below. Any other argmnents or flags (e.g., -rC3) are passed to 
nroff{l) or to MM, as appropriate. Such options can occiu: in any order, but they must appear 
before the files arguments. If no arguments are given, mm prints a list of its options. 

-Tterm Specifies the type of output terminal; for a list of recognized values for term, type help 
terin2. If this option is not used, mm will use the value of the shell variable $TERM 
from the environment (see profile (4) and environ{5)) as the value of term, if STERM is 
set; otherwise, mm will use 450 as the value of term. If several terminal types are 
specified, the last one takes precedence. 

-12 Indicates that the document is to be produced in 12-pitch. May be used when ITERM 

is set to one of 300, SOOs, 450, and 1620. (The pitch switch on the DASI 300 and 300s 
terminals must be manually set to 12 if this option is used.) 

-c Causes mm to invoke co/(l); note that col{l) is invoked automaticaUy by mm imless 

term is one of 300, SOOs, 450, 37, 4000a, 382, 4014, tek, 1620, and X. 

-e Causes mm to invoke neqn. 

-t Causes mm to invoke tbl{l). 

-E Invokes the -e option of nroff. 

-y Causes mm to use the non-compacted version of the macros (see mm (5)). 

As an example (assiuning that the shell variable STERM is set in the environment to 450), the 
two command lines below are equivalent: 

mm -t -rC3 -12 ghh* 

tbl ghh* I nroff -cm -T450-12 -h -rC3 

Mm reads the standard input when - is specified instead of any file names. (Mentioning other 
files together with - leads to disaster.) This option allows mm to be used as a filter, e.g.: 

cat dws I mm - 

HINTS 

1. Mm invokes nro^ with the -h flag. With this flag, nro^ assmnes that the terminal has 
tabs set every 8 character positions. 

2. Use the -olist option of nroff to specify ranges of pages to be output. Note, however, 
that mm, if invoked with one or more of the -e, -t, and - options, together with the 
-olist option of nroff may cause a harmless "broken pipe" diagnostic if the last page of 
the document is not specified in list. 

3. If you use the -a option of nroff (to stop between pages of output), use line-feed (rather 
than retiun or new-line) to restart the output. The -s option of nro^ does not work with 
the -c option of mm, or if mm automatically invokes co/(l) (see -c option above). 

4. If you lie to mm about the kind of terminal its output will be printed on, you'll get (often 
subtle) garbage; however, if you are redirecting output into a file, use the -T37 option, 
and then use the appropriate terminsil filter when you actually print that file. 
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SEE ALSO 

col(l), cw(l), env(l), nroflF(l), tbl(l), profile(4), imn(5), tenn(5). 

MM-Memorandum Macros in HP-UX Selected Articles. 

DIAGNOSTICS 

mm "mm: no input file" if none of the arguments is a readable file Eind mm is not used as a filter. 
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NAME 

more, page - file perusal filter for crt viewing 

SYNOPSIS 

more [ -n ] [ -cdflsu ] [ +linenmnber ] [ -|-/pattem ] [ name ... ] 

page [ more options ] 

REMARKS: 

The use of pg{l) is preferred. 

DESCRIPTION 

More is a filter which allows examination of continuous text, one screenful at a time, on a soft- 
copy terminal. It is quite similar to pg{l), and the user is encouraged to use pg instead. It is 
retained for backward compatibility. It normally pauses after each screenful, printing — More — 
at the bottom of the screen. If the user then types a carriage return, one more line is displayed. 
If the user hits a space, another screenful is displayed. Other possibilites are enmnerated later. 

The command line options are: 

—n An integer which is the size (in lines) of the window which more will use instead 

of the default. 

-c More will draw each page by beginning at the top of the screen and erasing each 

line just before it draws on it. This avoids scrolling the screen, mtiking it easier 
to read while more is writing. This option will be ignored if the terminal does 
not have the ability to clear to the end of a line. 

-d More will prompt the user with the message "Hit space to continue, Rubout to 

abort" at the end of each screenful. This is useful if more is being used as a filter 
in some setting, such as a class, where many users may be unsophisticated. 

-f This causes more to count logical lines, rather than screen lines. That is, long 

lines are not folded. This option is recommended if nroff output is being piped 
through «/, since the latter may generate escape sequences. These escape 
sequences contain characters which would ordinarily occupy screen postions, but 
which do not print when they are sent to the terminal as part of an escape 
sequence. Thus more may think that lines are longer than they actually are, and 
fold lines erroneously. 

-1 Do not treat *L (form feed) specially. If this option is not given, more will pause 

after any line that contains a *L, as if the end of a screenful had been reached. 
Also, if a file begins with a form feed, the screen will be cleared before the file is 
printed. 

-8 Squeeze multiple blank lines from the output, producing only one blank line. 

Especially helpful when viewing nroff output, this option maximizes the useful 
information present on the screen. 

-u Normally, more will handle imderlining and bold such as produced by nroff in a 

manner appropriate to the particular terminal: if the terminal can perform 
imderlining or has a stand-out mode, more will output appropriate escape 
sequences to enable imderlining, else stand-out mode, for underlined information 
in the source file. If the terminal can perform stand-out, more uses that mode 
for bold information. The -u option suppresses this processing, as do the "ul" 
and "os" terminfo flags. 

+linenumber Start up at linenumber. 

+pattern Start up two lines before the line containing the regular expression pattern. 
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If the program is invoked as page, then the screen is cleared before each screenful is printed (but 
only if a full screenful is being printed), and k - 1 rather than fc - 2 lines are printed in each 
screenful, where k is the nmnber of lines the terminal can display. 

More uses terminfo descriptor files to determine terminal characteristics, and to determine the 
default window size, see term (4). On a terminsd capable of displaying 24 lines, the default win- 
dow size is 22 lines. 

More looks in the environment variable MORE to pre-set any flags desired. For example, if you 
prefer to view files using the -c mode of operation, the shell command sequence MORE='-c' ; 
export MORE or the csh command aetenv MORE -c would cause all invocations of more, includ- 
ing invocations by programs such as man smd msgs, to use this mode. Normally, the user will 
place the command sequence which sets up the MORE environment variable in the .profile or 
.cskrc file. 

If more is reading from a file, rather than a pipe, then a percentage is displayed along with the 
— More — prompt. This gives the fraction of the file (in characters, not lines) that has been 
read so far. 

Other sequences which may be typed when more pauses, and their eflFects, are as follows (i is an 
optional integer argument, defaulting to 1) : 

i<space> display t more lines, (or another screenful if no argmnent is given). 

*D display 11 more lines (a "scroll"). If t is given, then the scroll size is set to t. 

d same as "D (control-D). 

tz same as typing a space except that »', if present, becomes the new window size. 

ts skip t lines and print a screenful of lines. 

tf skip t screenfuls and print a screenful of lines. 

"q or Q" Exit from more. 

= Display the current line nmnber. 

V Start up the editor vi at the cmrent line. 

h Help command; give a description of all the more commands. 

i/expr search for the i-th occurrence of the regular expression expr. If there are less 

than t occurrences of expr, and the input is a file (rather than a pipe), then the 
position in the file remains unchanged. Otherwise, a screenful is displayed, start- 
ing two lines before the place where the expression was found. The user's erase 
and kill characters may be used to edit the regular expression. Erasing back past 
the first column cancels the search command. 

t'n search for the t'-th occurrence of the last regular expression entered. 

(single quote) Go to the point from which the last search started. If no search 
has been performed in the current file, this conunand goes back to the beginning 
of the file. 

Icommand invoke a shell with command. The characters "%" and "!" in "command" are 

replaced with the current file name and the previous shell command respectively. 
If there is no current file name, "%" is not expanded. The sequences '\%" and 
"\!" are replaced by "%" and "!" respectively. 

t:n skip to the »-th next file given in the command line (skips to last file if n doesn't 

make sense). 

»:p skip to the »-th previous file given in the command line. If this command is 

given in the middle of printing out a file, then more goes back to the beginning 
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of the file. If t doesn't make sense, more skips back to the first file. If more is 
not reading from a file, the bell is nmg and nothing else happens. 

:f display the current file name and line number. 

":q or :Q" exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not necessary to tjrpe a carriage return. Up to 
the time when the conmiand character itself is given, the user may hit the line kill character to 
cancel the numerical argmnent being formed. In addition, the user may hit the erase character to 
redisplay the — More — {x3%). 

At any time when output is being sent to the termmal, the user can hit the quit key (normally 
control-\). More will stop sending output, and will display the usual — More — prompt. The 
user may then enter one of the above commands in the normal manner. Unfortunately, some out- 
put is lost when this is done, due to the fact that any characters waiting in the terminal's output 
queue are flushed when the quit signal occurs. 

The terminal is set to noecho mode by this program so that the output can be continuous. What 
you type will thus not show on your terminal, except for the / and ! conunands. 

If the standard output is not a teletype, then more acts just like cat{l), except that a header is 
printed before each file (if there is more than one). 

A sample usage of more in previewing nroff output would be 

nroff -ms +2 doc.n I more -s 

FILES 

/usr/lib/more.help help file 

/usr/lib/terminfo/?/* compiled terminal capability data base 

VARIABLES 

MORE Default paging mode. 

AUTHOR 

More was developed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

csh(l), man(l), pg(l), sh(l), term(4), terminfo(4), environ(5). 

INTERNATIONAL SUPPORT 

more: 8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

mt - magnetic tape manipiilating program 

SYNOPSIS 

mt [ -t tapename ] command [ count ] 

DESCRIPTION 

Mt is used to give commands to the tape drive. If tapename is not specified, /dev/mt/Omn is 
used. If count is not specified, 1 is assumed. 

Here are the commands: 

eof write count end-of-file marks 

fsf space forwEird count files 

fsr space forward count records 

bsf space backward count files 

bsr space backward count records 

rew rewind tape 

offl rewind tape and go offline. 

FILES 

/dev/mt/* Magnetic tape interface 

/dev/rmt/* Raw magnetic tape interface 

/dev/rmt/Omn (or whatever drive is used) must be described as a Berkeley-compatibility 

mode tape drive (without rewind) for mt to operate as expected. 

AUTHOR 

Mt was developed by the University of California, Berkeley California, Computer Science Division, 
Department of Electrical Engineering and Computer Science. 

SEE ALSO 

dd(l), mt(7). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NANfE 

neqn - format mathematical text for uioS 

SYNOPSIS 

neqn [ -dxy ] [ -sn ] [ -fh ] [ -pn ] [ files ] 

DESCRIPTION 

Neqn is a preprocessor for nroff{l) for typesetting mathematical text on typewriter- like terminals. 
Usage is almost always: 

neqn files | nroflF 

or equivalent. 

If no files are specified (or if - is specified as the last argvmient), nroff reads from the standard 
input. A line beginning with .EQ marks the start of an equation; the end of an equation is 
marked by a line beginning with .EN. Neither of these lines is altered, so they may be defined m 
macro packages to get centering, numbering, etc. It is also possible to designate two characters as 
delimiters; subsequent text between delimiters is then treated as neqn input. Delimiters may be 
set to characters x £md y with the command-line argument —dxy or (more commonly) with delim 
xy between .EQ and .EN. The left and right delimiters may be the same character; the dollar 
sign is often used as such a delimiter. Delimiters are turned oflF by delim oflF. All text that is nei- 
ther between delimiters nor between .EQ and .EN is passed through imtouched. 

Tokens within neqn are separated by spaces, tabs, new-lines, braces, double quotes, tildes, and 
circmnflexes. Braces { } are used for grouping; generally speaking, anywhere a single character 
such as I could appear, a complicated construction enclosed in braces may be used instead. Tilde 
(~) represents a full space in the output, circiunflex (^) half as much. 

Subscripts and superscripts are produced with the keywords sub and sup. Thus: 
X sub j makes $x sub j$, 
a sub k sup 2 produces: 

$a sub k sup 2$, 

while: 

$e sup {x sup 2 -h y sup 2}$ is made with e sup {x sup 2 + y sup 2} . 

Fractions are made with over: 

a over b yields $a over b$; 

sqrt makes square roots: 

1 over sqrt {ax sup 2+bx+c} results in $1 over sqrt {ax sup 2 -|-bx-|-c}$ . 

The keywords from and to introduce lower and upper limits: 

Slim from {n -> inf} smn from to n x sub i$ is made with 
Urn from {n -> inf } sum from to n x sub i" . 
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Left and right brackets, braces, etc., of the right height are made with left and right: 

left [ X sup S + y sup 2 over alpha right ] ~=~ 1 produces $left [ x sup 2 + y 
sup 2 over alpha right ] "=' 1$. 

Legal characters after left and right are braces, brackets, bars, c and f for ceiling and 
floor, and "' for nothing at all (useful for a right-side-only bracket). A left thing need 
not have a matching right thing. 

Vertical piles of things are made with pile, Ipile, cplle, and rpile: 

pUe {a above b above c} produces $pile {a above b above c}$. 

Piles may have arbitrary niunbers of elements; Ipile left-justifies, pile and cpile center 
(but with different vertical spacing), and rpile right justifies. 

Matrices are made with matrix: 

matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2}} produces $matrix { Icol 
{ X sub i above y sub 2 } ccol { 1 above 2 } }$. 

In addition, there is rcol for a right-justified colimui. 

Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: 

X dot = f(t) bar is $x dot = f(t) bar$, 

y dotdot bar " =~ n under is $y dotdot bar ~=' n underS, and 

X vec ~ =~ y dyad is $x vec ~=~ y dyad$. 

Point sizes and fonts can be changed with size n or size ±n, roman, italic, bold, and 
font n. Point sizes and fonts can be changed globally in a document by gsize n and 
gfont n, or by the command-line argiunents -sn and -in. 

Normally, subscripts and superscripts are reduced by 3 points from the previous size; this 
may be changed by the command-line argument -pn. 

Successive display arguments can be lined up. Place mark before the desired lineup 
point in the first equation; place lineup at the place that is to line up vertically in subse- 
quent equations. 

Shorthands may be defined or existing keywords redefined with define: 

define thing % replacement % 

defines a new token called thing that will be replaced by replacement whenever it appears 
thereafter. The % may be any character that does not occiu- in replacement. 

Keywords such as sum ( sum ), int ( int ), inf ( inf ), and shorthands such as >= (>=), 
!=(!=), and -> (->) are recognized. Greek letters are spelled out in the desired case, as 
in alpha ( alpha ), or GAMMA ( GAMMA ). Mathematical words such as sin, cos, and 
log are made Roman automatically. Nroff{l) foiur-character escapes such as \(dd (t) and 
\(bu (•) may be used anywhere. Strings enclosed in double quotes ("...") are passed 
through untouched; this permits keywords to be entered as text, and can be used to com- 
municate with nroff{l) when all else fails. Details are given in the manuals cited below. 

SEE ALSO 

Typesetting Mathematics-User's Guide by B. W. Kemighan and L. L. Cherry. 
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New Graphic Symbols for EQN and NEQN by C. Scrocca. 
cw(l), min(l), nroff(l), tbl(l), mm(5). 

BUGS 

To embolden digits, parentheses, etc., it is necessary to quote them, as in bold "12.3". 
See also BUGS mider nroff{l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

newform - change or reformat a text file 

SYNOPSIS 

newform [-itabspec] [-otabspec] [-In] [-bn] [-en] [-cchar] [-pn] [-an] [-f] [-s] [files] 

DESCRIPTION 

Newform reads lines from the named files, or the standard input if no input file is named, and 
reproduces the lines on the standard output. Lines are reformatted in accordance with command 
line options in effect. 

Except for -s, command line options may appear in any order, may be repeated, and may be 
intermingled with the optional files. Command line options are processed in the order specified. 
This means that option sequences like "-el5 -160" will yield results different from "-160 -el5". 
Options are applied to all files on the command line. 

-itahspec Input tab specification: expands tabs to spaces, according to the tab specifications 
given. Tabspec recognizes all tab specification forms described in tabs{l). In addition, 
tabspec may be — , in which newform assiunes that the tab specification is to be found 
in the first line read from the standard input (see /spec (4)). If no tabspec is given, 
tabspec defaults to -8. A tabspec of -0 expects no tabs; if any are found, they are 
treated as -1. 

-otabspec Output tab specification: replaces spaces by tabs, according to the tab specifications 
given. The tab specifications are the same as for -itabspec. If no tabspec is given, 
tabspec defaults to -8. A tabspec of -0 means that no spaces will be converted to tabs 
on output. 

-In Set the effective line length to n characters. If n is not entered, -1 defaults to 72. The 

default line length without the -1 option is 80 characters. Note that tabs and back- 
spaces are considered to be one character (use -i to expand tabs to spaces). 

-bn Tnmcate n characters from the beginning of the line when the line length is greater 

than the effective line length (see -In). Default is to tnmcate the number of charac- 
ters necessary to obtain the effective line length. The default value is used when -b 
with no n is used. This option can be used to delete the sequence numbers from a 
COBOL program as follows: 

newform -11 -b7 file-name 

The -11 must be used to set the effective line length shorter than any existing line in 
the file so that the -b option is activated. 

-en Same as -bn except that characters are tnmcated from the end of the line. 

-ck Change the prefix/ append character to k. Default character for A; is a space. 

-pn Prefix n characters (see -ck) to the beginning of a line when the line length is less than 

the effective line length. Default is to prefix the nimiber of characters necessary to 
obtain the effective line length. 

—an Same as — pn except characters are appended to the end of a line. 

— f Write the tab specification format line on the standard output before any other lines 

are output. The tab specification format line which is printed will correspond to the 
format specified in the last -o option. If no -o option is specified, the line which is 
printed will contain the default specification of -8. 

-8 Shears off leading characters on each line up to the first tab £ind places up to 8 of the 

sheared chfu-acters at the end of the line. If more than 8 characters (not counting the 
first tab) are sheared, the eighth character is replaced by a * and any characters to the 
right of it are discarded. The first tab is always discarded. 
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An error message and progreiiii exit will occur if this option is used on a nie without a 
tab on each line. The characters sheared oiF are saved internally imtil all other options 
specified are applied to that line. The characters are then added at the end of the pro- 
cessed line. 

For example, to convert a file with leading digits, one or more tabs, and text on each 
line, to a file beginning with the text, all tabs after the first expanded to spaces, pad- 
ded with spaces out to column 72 (or truncated to column 72), and the leading digits 
placed starting at colimin 73, the command would be: 
newform -s -i -1 -a -e file-name 

DIAGNOSTICS 

All diagnostics are fatal. 

usage: . . . Newform was called with a bad option. 

not -3 format There was no tab on one line. 

can 't open file Self-explanatory. 

internal line too long A line exceeds 512 characters after being expanded in the internal work 

buffer. 
tabspec in error A tab specification is incorrectly formatted, or specified tab stops are 

not ascending. 
tabspec indirection illegal A tabspec read from a file (or standard input) may not contain a 

tabspec referencing another file (or standard input). 

EXIT CODES 

- normal execution 

1 - for any error 

SEE ALSO 

fspec(4), csplit(l), tabs(l). 

BUGS 

Newform normally only keeps track of physical characters; however, for the -i and -o options, 
newform will keep track of backspaces in order to line up tabs in the appropriate logical columns. 

Newform will not prompt the user if a tabspec is to be read from the standard input (by use of 
-i— or -o— ). 

If the -f option is used, and the last -o option specified was -o — , and was preceded by either a 
-o — or a -i — , the tab specification format line will be incorrect. 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [-] [ group ] 

DESCRIPTION 

Newgrp changes a user's group identification. The user remains logged in and the current direc- 
tory is unchanged, but calculations of access permissions to files are performed with respect to the 
new real and effective group IDs. The user is always given a new shell, replacing the current shell, 
by newgrp, regardless of whether it terminated successfully or due to an error condition (i.e., imk- 
nown group). 

EJxported variables retain their values after invoking newgrp; however, all unexported variables 
are either reset to their default value or set to null. Environment variables (such as PSl, PS2, 
PATH, MAIL, and HOME), unless exported by the system or explicitly exported by the user, are 
reset to default values. For example, a user has a primary prompt string (PSl) other than S 
(default) and has not exported PSl. After an invocation of newgrp , successful or not, their PSl 
will now be set to the default prompt string $. Note that the shell command export (see sh{\)) is 
the method to export variables so that they retain their assigned value when invoking new shells. 

With no argmnents, newgrp changes the group identification back to the group specified in the 
user's password file entry. 

If the first argument to newgrp is a -, the environment is changed to what would be expected if 
the user actually logged in again. 

A password is demanded if the group has a password and the user does not, or if the group has a 
password and the user is not listed in /etc/group as being a member of that group. 

FILES 

/etc/group system's group file 

/etc/passwd system's password file 

SEE ALSO 

login(l), sh(l), group(4), passwd(4), environ(5). 

DIAGNOSTICS 

Sorry: You didn't qualify as a group member. 

Unknown group: The group name was not in /etc/group. 

Permission denied: If a password must be given, it can 
only come from a teletype port. 

If the atdin is a non-tty file, this message is given: 
You have no shell: Exec of the shell failed. 

BUGS 

There is no convenient way to enter a password into /etc/group. 

Use of group passwords is not encoiu-aged, because, by their very nature, they encourage poor 
security practices. Group passwords may disappear in the future. 

Shell variables which are not exported are lost. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

news - print news items 

SYNOPSIS 

news [ -a ] [ -n ] [ -8 ] [ items ] 

DESCRIPTION 

Nexoa is used to keep the user informed of current events. By convention, these events are 
described by files in the directory /iisr/news. 

When invoked without argtunents, news prints the contents of all current files in /usr/news, 
most recent first, with each preceded by an appropriate header. News stores the "currency" time 
as the modification date of a file named .news_tiine in the user's home directory (the identity of 
this directory is determined by the environment variable IHOME); only files more recent than 
this currency time are considered "ciurent." 

Options 

-a Causes news to print all items, regardless of currency. In this case, the stored 

time is not changed. 

-n Causes news to report the names of the current items without printing their con- 

tents, and without changing the stored time. 

-s Causes news to report how many current items exist, without jmnting their 

names or contents, and without changing the stored time. It is useful to include 
such an invocation of news in one's .profile file, or in the system's /etc/profile. 

All other argimients are assumed to be specific news items that are to be printed. 

If an interrupt is typed during the printing of a news item, printing stops and the next item is 
started. Another delete within one second of the first causes the program to terminate. 

FILES 

/usr/news/* 

$HOME/.news_tune 

/etc/profile 

SEE ALSO 

mail(l), profile(4), environ(5). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

nice - run a command at low priority 

SYNOPSIS 

nice [ -increment ] command [ argmnents ] 

DESCRIPTION 

Nice executes command with a lower CPU scheduling priority. If the increment argmnent (in the 
range 1-19) is given, it is used; if not, an increment of 10 is assumed. 

The super-user may nm commands with priority higher than normal by using a negative incre- 
ment, e.g., — 10. 

An increment larger than 19 is equivalent to 19. 

HARDWARE DEPENDENCIES 

Series 500: 

A note to the super-user: be careful about increasing the priority of your processes. Yom- 
keyboard process is running at a nice value of 1, 2, 3, or 4. If you should assign a process 
a nice value of 0, you will lock out yoin: keyboard, forcing you to reboot the system. 

SEE ALSO 

nohup(l), nice(2). 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 

NOTES 

Nice is built into csh{\) with a slightly different syntax than described here. The form "nice 
-f-10" nices to positive nice, and "nice -10" can be used by the super-user to give a process more of 
the processor. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

nl - line numbering filter 

SYNOPSIS 

nl [-btjT)e] [-htype] [-ftype] [-p] [-vstart#] [-iincr] [-ssep] [-wwidth] [-nformat] [-Inum] 
[-ddelim] file 

DESCRIPTION 

Nl reads lines from the named file or the standard input if no file is named and reproduces the 
lines on the standard output. Lines are nmnbered on the left in accordance with the command 
options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is reset at the start of each 
logical page. A logical page consists of a header, a body, sind a footer section. Empty sections are 
valid. Different line numbering options are independently available for header, body, and footer 
(e.g., no numbering of header and footer lines while numbering blank lines only in the body). 

The start of logical page sections are signaled by input lines containing nothing but the following 
delimiter character (s): 

Line contents Start of 

\:\:\: header 






body 
footer 



Unless told otherwise, nl assmnes the text being read is in a single logical page body. 

Command options may appear in any order and may be intermingled with an optionsil file name. 
Only one file may be named. The options are: 

-htype Specifies which logical page body lines are to be nmnbered. Recognized types and their 
meanings are: 

a niunber all lines; 

t nmnber lines with printable text only; 

n no line numbering; 

pstring number only lines that contain the regular expression 

specified in string. 

The default type for logical page body is t (text lines numbered). 

-htype Same as -htype except for header. Default type for logical page header is n (no lines 
nmnbered). 

-ftype Same as -htype except for footer. Default for logical page footer is n (no lines num- 
bered). 

-p Do not restart niunbering at logical page delimiters. 

-\start# Startif^ is the initial value used to number logical page lines. Default is 1. 

-\incr Incr is the increment value used to nmnber logical page lines. Default is 1. 

ssep Sep is the character(s) used in separating the line number and the corresponding text 

line. Default sep is a tab. 

-wwidth Width is the nmnber of characters to be used for the line nmnber. Default width is 6. 

-nformat Format is the line niunbering format. Recognized v£ilues are: 

In left justified, leading zeroes suppressed; 

rn right justified, leading zeroes suppressed; 
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rz right justified, leading zeroes kept. 

Default format is m (right justified). 

-Inum Num is the number of blank lines to be considered as one. For example, -12 

results in only the second adjacent blank being numbered (if the appropriate -ha, 
-ba, and/or -fa option is set). Default is 1. 

-docx The delimiter characters specifying the start of a logical page section may be 

changed firom the default characters (\:) to two user-specified characters. If only 
one character is entered, the second character remains the default character (:). 
No space should appear between the -d and the delimiter characters. To enter a 
backslash, use two backslashes. 

EXAMPLE 

The command: 

nl -vlO -ilO -dl-l- filel 

will niunber filel starting at line niunber 10 with an increment of ten. The logical page delimiters 
are ! and +. 

SEE ALSO 

pr(l). 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

nm - print name list of common object file 

SYNOPSIS 

nm [ -oxefuV ] file. . . 

DESCRIPTION 

The nm command displays the symbol table of each conmion object file file. File may be relocat- 
able or absolute common object file, or it may be an archive of relocatable or absolute common 
object files. For each symbol, at least the following information will be printed: 

Name The name of the symbol. 

Value Its value expressed as an offset or an address depending on its storage class. 

Size Its size in bytes, if available. 

The output of nm may be controlled using the following options: 

-o Print the value and size of a symbol in octal instead of decimal. 

-X Print the value and size of a symbol in hexadecimal instead of decimal. 

-e Print only external and static sjonbols. 

-f Produce full output. Print redimdant symbols (.text, .data and .bss), normally 

suppressed. 

-u Print imdefined symbols only. 

-V Print the version of the nm command executing on the standard error output. 

HARDWARE DEPENDENCIES 

Series 800 

The size of a symbol is not available, so there is no column for it in the output. The follow- 
ing additional fields are printed for each symbol: 

Scope The scope of the symbol (undefined, static, or external). 

Type The type of the symbol (code, data, common, absolute, etc.). 

Subspace The subspace to which the sjrmbol belongs. 

Additional options on Series 800 systems: 

-h Do not display the output header data. 

-V Sort symbols by value before they are printed. 

-n Sort symbols by name before they are printed. 

-p Produce easily parsable, terse output. Each symbol name is preceded by its 

value (blanks if undefined) and one of the letters U (imdefined), A (absolute), T 
(text symbol), D (data symbol), B (bss symbol), or C (common symbol). If the 
symbol is local (non-external), the type letter is in lower case. 

-r Prefix each output line with the name of the object file or archive. 

-T By default, nm prints the entire name of the symbols listed. Since object files 

can have symbol names with an arbitrary number of characters, a name that is 
longer than the width of the column set aside for names will overflow its column, 
forcing every colmnn after the name to be misaligned. The -T option causes nm 
to truncate every name that would otherwise overflow its column and place an 
asterisk as the last character in the displayed name to mark it as truncated. 

The -e and -f options are meaningless on Series 800 systems and are ignored. 
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SEE ALSO 

cc(l), ld(l). 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

mn - print name list (symbol table) of object file 

SYNOPSIS 

nm [-gnoprsu] [ file ... ] 

DESCRIPTION 

The nm command prints the name list (symbol table) of each object file in the argument list. If 
an argument is an archive, a listing for each object file in the archive will be produced. If no file 
is given, the symbols in a.out jire listed. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters U 
(undefined), A (absolute), T (text segment symbol), D (data segment symbol), or B (bss segment 
symbol). If the symbol is local (non-external) the type letter is in lower case. The output is 
sorted alphabetically. 

The options are: 

-g Print only global (external) symbols. 

— n Sort numericcilly rather than aJphabetically. 

— o Precede each output line with the file or archive element name, rather than 

printing the file or archive element name only once. This option can be used to 
make piping to grep(l) more meaningful. 

-p Do not sort; print in symbol-table order. 

-r Sort in reverse order. 

-8 Sort according to the size of the external symbol (computed from the diff^erence 

between the value of the symbol and the value of the symbol with the next 
highest value). This difference is the value printed. This flag tmns on -g and 
-n and turns off -u and -p. 

-u Print only undefined symbols. 

If the symbol was an align symbol, the letter L will be printed after the letter describing its type. 

SEE ALSO 

ar(l), a.out(4), ar(4). 
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NAME 

nm - print name list (symbol table) of object file 

SYNOPSIS 

nm [ -gnopru ] [ file ... ] 

Remarks: 

This manual page describes nm as implemented on the Series 500 computers. Refer to other nm 
manual pages for information valid for other implementations. 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument Ust. If an argument is 
an archive, a listing for each object file in the archive will be produced, preceded by the member 
name on a separate line. If no file is given, the symbols in a.out are listed. 

Options are: 

— g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output line rather than only once. This 
option can be used to make piping to grep{l) more meaningful. 

-p Don't sort; print in symbol-table order. 

— r Sort in reverse order. 

— u Print only imdefined symbols. 

The output from nm consists of five coliunns of data. The following is a portion of a typical out- 
put: 



X 


IDATA 


00000108 


A iob 


X 


IDATA 


000002aO 


A sctab 


X 


ICOMM 


00000400 00000440 


A sibuf 


X 


ICOMM 


00000400 00000840 


A sobuf 




UDATA 


00000c40 


Aallocs 


X 


FUNC 


EDS c04 002a8 00000003 


^cleanup 


X 


DDATA 


DR 00000098 


retype 


. X 


FUNC 


EDS cOc 00000 00000001 


^doscan 


X 


SYSTEM 


EPP004 0000e 


__exit 


X 


DDATA 


DR 00000038 


iob 


X 


DCOMM 


00000004 OOOOOObO 


^pfile 


X 


DDATA 


DR 00000090 


sctab 


X 


PTR 


1 00000a 000000b4 


sibuf 


X 


PTR 


1 00000c OOOOOObS 


sobuf 




FILENAME 


0000000a 


_exit.o 




FILENAME 


OOOOOOOf 


_print.o 



From left to right, the first column specifies whether the symbol is defined (.) or imdefined (U). 
The second column specifies whether the symbol is non-external (.) or external (X). The third 
column gives the linker symbol type (as defined in a.out.h and described below). The fourth 
coliunn lists the data associated with the specified symbol type. The fifth column gives the name 
of the system call, file, variable, array, common, etc., described by that entry in the symbol table. 

Up to four data elements are reported in the fourth column. If they are not symbolic values (such 
as 'EDS' or 'DR'), then they are hexadecimal values. The number of data elements reported 
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depends on the symboi type. Each symbol type has one to four parameters associated with it, 
whose values are given by the data elements in the fourth coltunn. The symbol types and associ- 
ated parameters are discussed below. 

The following symbol tjrpes are supported: 



ABS 



not cmrently generated; reserved for future use. 



FUNC or ENTRY specifies that the entry refers to a function or procedure call. Foiu- nimibers, 
ptr—type, segment, offset, and stt^index, are associated. Their values are 
given in order, from left to right, by the data elements. Ptr—type consists of 
a single bit that is always cleared. It is symbolically represented by 'EDS'. 
Ptr—type is meaningful to the linker (see W(l)), and specifies the storage for- 
mat of the call in the sjmibol table. Segment specifies the code segment 
number (a number in the range 3073 to 4095, that indicates which code seg- 
ment in the user's program space contains the desired code). Offset specifies 
the number of bytes from the beginning of the code segment where the func- 
tion or procedtu* code begins. Stt— index is an indirect reference to the 
beginning of the function or procedure code. 



SYSTEM 



LABEL 



DDATA 



specifies that the entry refers to a procedm* call directly into the system 
kernel. Three numbers, entry— type, segment, and stt, are associated. Their 
values are given by the data elements. Entry— type consists of a single bit 
that is always set. Its value is symbolically represented by 'EPP'. 
Entry— type is meaningful to the linker, and specifies the storage format of 
the call in the symbol table. Segment specifies the system code segment 
number (the number of a code segment among those set aside for system 
use; typically in the range to 64). Stt is an indirect pointer to the begin- 
ning of the procedure code. 

specifies that the entry is the destination address for a branch instruction. 
Three numbers, ptr—type, segment, and offset, are associated. Their values 
are given by the data elements. Ptr—type consists of a single bit which is 
always cleared. Its value is sjrmbolically represented by 'EDS'. Ptr—type is 
meaningful to the linker, and specifies the storage format of the address in 
the symbol table. Segment specifies the user code segment number. Offset 
specifies the niunber of bytes from the beginning of the code segment where 
the label begins. 

specifies that the entry is a directly-addressable, initialized data structure (a 
variable, or the beginning of an array, common, structiu*, etc.). Two 
niunbers, base—reg and displacement, are associated. Their values are given 
by the data elements. Base—reg is assigned one of nine possible symbolic 
values which describe the addressing scheme used to find the data structure. 
It is meaningful to the linker. The possible symbolic values are P-I-, P-, DB, 
DL, Q-I-, Q-, SB, S-, and DR. Displacement specifies the byte offset where 
the data structure is located. Note that this ofiFset is measured relative to 
the beginning of the data space of the file for which the nm listing is made. 
The actu£il byte offset of the data structm-e in the executable a.out file 
could change. 



roATA or UDATA 



specifies that the entry refers to an indirectly-addressable, uninitialized 
«uTay, or an indirectly-addressable, initialized common block. One number, 
displacement, is associated. Its value is given by the data element. It is 
identical to the displacement described above imder DDATA. 
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DCOMM or ICOMM 

specifies that the entry is treated as a common block. Three nmnbers, 
blocksize, needs— length^-word, and displacement, are associated. Their 
values are given by the data elements. Blocksize is the size, in bytes, of the 
common block. Needs— length^-Word is a boolean value which appears in a 
print-out as either or 1. If its value is 1, the linker places the vsilue of 
{blocksize - 4) in the first four bytes of the common block. This information 
is necessary when linking FORTRAN programs. Displacement is identical 
to that described imder DDATA above. 



PTR 



SEGMENT 
FILENAME 



specifies that the entry is a pointer to an indirectly-addressable data struc- 
tiu-e (variable, array, common block, etc.). Three numbers, 
ptr—to— common, target, and address, are associated. Their values are given 

by the data elements. Ptr—to common is an eight-bit boolean expression. 

Its vsilue is given as 1 (true) or (false). If true, then the entry is a pointer 
to a common block. If false, the entry is a pointer to some other type of 
data structure. Target is an index into the symbol table to the entry that 
describes the target of the data structure pointer. Address is a pointer to 
the data structure pointer; that is, an indirect pointer to the data structinre. 

not currently generated; reserved for future use. 

specifies that the entry is a file name. One nvunber, sequence, is associated. 
Its value is given by the data element. Sequence refiects the order in which 
the linker encountered each file name. 



SEE ALSO 

ar(l), a.out(5), ar(5). 

DIAGNOSTICS 

Nm generates an error message for the following conditions: 
invalid option 
CEinnot open file 
bad magic nimiber 
read error 
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NAME 

nohup - run a command unmune to hangups, logouts, and quits 

SYNOPSIS 

nohup command [ argmnents ] 

DESCRIPTION 

Nohup executes command with hangups and quits ignored. If output is not re-directed by the 
user, both standard output and standard error are sent to nohup.out. If nohup.out is not writ- 
able in the current directory, output is redirected to $HOME/nohup.out; otherwise, nohup will 
fail. 

If output from nohup is redirected to a termineil, or is not redirected at all, the output is sent to 
nohup.out. 

EXAMPLE 

It is frequently desirable to apply nohup to pipelines or lists of commands. This can be done only 
by placing pipelines and command lists in a single file, called a shell procedure. One can then 
issue: 

nohup sh file 

and the nohup applies to everything in file. If the shell procedure file is to be executed often, then 
the need to type sh can be eliminated by giving file execute permission. Add an ampersand and 
the contents of file are run in the background with interrupts also ignored (see sA(l)): 

nohup file &: 

An example of what the contents of file could be is: 

tbl ofile I eqn I nroff > nfile 

SEE ALSO 

chmod(l), nice(l), sh(l), signal(2). 

WARNINGS 

Be csireful to place punctuation properly, for example in the following command: 

nohup command 1; command2 

nohup applies only to commandl, and the following command is syntactically incorrect: 

nohup (commandl; command2) 

Be careful of where standard error is redirected. The following command may put error messages 
on tape, making it imreadable: 

nohup cpio -o <li8t >/dev/rmt/lm& 
while 

nohup cpio -o <list >/dev/rmt/lm 2>errors& 

puts the error messages into file errors. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

nroflf - format text 

SYNOPSIS 

nroff [ options ] [ files ] 

DESCRIPTION 

Nroff formats text contained in files (standard input by default) for printing on typewriter-like 
devices and line printers. Its capabilities are described in the NROFF /TROFF User's Manual 
cited below. 

Nroff is best not used directly, but rather via macro packages such as mm or ms which provide a 
high-level interface to document processing, as opposed to the very low level one provided directly 
in nroff. 

An argument consisting of a minus (-) is taken to be a file name corresponding to the standard 
input. The options, which may appear in any order, but must appear before the files, are: 

-olist Print only pages whose page numbers appear in the list of numbers and ranges, 

separated by commas. A range N-M means pages N through M; an initial -N 
means from the beginning to page N; and a final N- means from N to the end. 
(See BUGS below.) 

-n^ Number first generated page N. 

-aN Stop every N pages. Nroff will halt after every N pages (default N=l) to allow 

paper loading or changing, and will resume upon receipt of a line-feed or new-line 
(new-lines do not work in pipelines, e.g., with mm(l)). When nroff halts 
between pages, an ASCII BEL is sent to the terminal. 

-raN Set register a (which must have a one-character name) to N. 

-i Read standard input after files are exhausted. 

-q Invoke the simultaneous input-output mode of the .rd request. 

-z Print only messages generated by .tm (terminal message) requests. 

-mname Precede the input files with the non-compacted (ASCII text) macro file 

/usr/Iib/tmac/tmac. name . 

-cname Precede the input files with the compacted macro files 

/usr /lib/macros/cmp. [nt] . [dt] . name and 
/usr/lib/macros/ucmp. [nt] . name . 

-kname Compsict the macros used in this invocation of nroff, placing the output in files 

[dt]. name in the current directory (see the May 1979 Addendiun to the 
NROFF /TROFF User's Manual for details of compacting macro files). 

-Tname Prepare output for specified terminal. Known names are 37 for the (default) 

TELETYPE Model 37 terminal, tnSOO for the GE TermiNet 300 (or any termi- 
nal without half-line capability), 3008 for the DASI 300s, 300 for the DASI 300, 
450 for the DASI 450, Ip for a (generic) ASCII line printer, 382 for the DTC-382, 
4000A for the Trendata 4000A, 832 for the Anderson Jacobson 832, X for a 
(generic) EBCDIC printer, 2631 for the Hewlett Packard 2631 line printer, and 
kip for a (generic) 16-bit character printer having ratio of 2 to 3 in 8-bit and 
16-bit character width. 

-€ Produce equally-spaced words in adjusted lines, using the full resolution of the 

particular terminal. 

-h Use output tabs during horizontal spacing to speed output and reduce output 

character coimt. Tab settings are assumed to be every 8 nominal character 
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widths. 

-un Set the emboldening factor (number of character overstrikes) for the third font 

position (bold) to n, or to zero if n is missing. 

HARDWARE DEPENDENCIES 

Series 500: 

The -c £ind -k options are not currently supported. 

FILES 

/usr/lib/macros/* standard macro files 

/usr/lib/term/* terminal driving tables for nroff 

/usr/lib/suftab suffix hyphenation tables 

/tmp/ta$# temporary file 

/usr/lib/tmac/tmac.* standard macro files and pointers 

SEE ALSO 

mm(l). 

NROFF/TROFF User's Manual in HP-UX: Selected Articles. 

BUGS 

When nroff is used with the -olist option inside a pipeline, it may cause a harmless "broken pipe" 
diagnostic if the last page of the dociunent is not specified in list. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

od, xd - octal and hexadecimal dump 

SYNOPSIS 

od [ -bcdosx ][ file ][[ + ][ Ox ]offset[ . ][ b ] ] 
xd [ -bcdosx ] [ file ] [ [ + ][ Ox ]offset[ . ][ b ] ] 

DESCRIPTION 

Od (xd) dimaps file in one or more formats as selected by the first argument. If the first argu- 
ment is missing, -o (-x) is the default. An offset field is inserted at the beginning of each line. 
For od, the offset is in octal, for xd the offset is in hexsidecimal. 

Options 

The meanings of the format options are: 

-b Interpret bytes in octal (hexadecimal). 

-c Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: 

null=\0, backspace=\b, form-feed=\f, new-line=\ii, retum=\r, tab=\t; others 
appear as 3-digit octal numbers. 

-d Interpret 16-bit words in decimal. 

-o Interpret 16-bit words in octal. 

-8 Interpret 16-bit words in signed decimal. 

-X Interpret 16-bit words in hexadecimal. 

The file argument specifies which file is to be dmnped. If no file argument is specified, the stan- 
dard input is used. 

The offset argument specifies the offset in the file where dmnping is to commence, and is normally 
interpreted as octal bytes. Interpretation can be altered as follows: 

offset must be preceded by -|- if the file argument is omitted. 

offset preceded by Ox is interpreted in hexadecimal. 

offset followed by . is interpreted in decimal. 

offset followed by b is interpreted in blocks of 512 bytes. 

Dmnping continues until end-of-file. 

SEE ALSO 

adb(l). 

INTERNATIONAL SUPPORT 

od: 8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

pack, peat, unpack - compress and expand files 

SYNOPSIS 

pack [ - ] [ -f ] name . . . 

peat name . . . 

unpack name . . . 

DESCRIPTION 

Pack attempts to store the specified files in a compressed form. Wherever possible (and useful), 
each input file name is replaced by a packed file name.z with the same access modes, access and 
modified dates, and owner as those of name. The -f option will force packing of name. This is 
useful for causing an entire directory to be packed even if some of the files will not benefit. If 
pack is successful, name will be removed. Packed files can be restored to their original form using 
unpack or peat. 

Pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the - argument is 
used, an internal flag is set that causes the nmnber of times each byte is used, its relative fre- 
quency, and the code for the byte to be printed on the standard output. Additional occurrences 
of - in place of name will cause the internal flag to be set and reset. 

The amount of compression obtained depends on the size of the input file and the character fre- 
quency distribution. Because a decoding tree forms the first part of each .z file, it is usually not 
worthwhile to pack files smaller than three blocks, unless the character frequency distribution is 
very skewed, which may occur with printer plots or pictures. 

Typically, text files are reduced to 60-75% of their original size. Load modules, which use a larger 
character set and have a more uniform distribution of characters, show little compression, the 
packed versions being about 90% of the original size. 

Pack returns a value that is the nmnber of files that it failed to compress. 

No packing will occur if: 

the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

the file is empty; 

no disk storage blocks will be saved by packing; 

a file called name.z Eilready exists; 

the .z file carmot be created; 

an I/O error occurred during processing. 

The last segment of the file name must contain no more than 12 characters to allow space for the 
appended .z extension. Directories cannot be compressed. 

Peat does for packed files what cat{l) does for ordinary files, except that peat cannot be used as a 
filter. The specified files are unpacked and written to the standard output. Thus to view a 
packed file named name.z use: 

peat name.z 

or just: 
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peat name 

To make an impacked copy, say nnn, of a packed file named name.z (without destroying nome.z) 
use the command: 

peat name >nnn 

Peat rettuns the number of files it was unable to unpack. Failure may occur if: 

the file name (exclusive of the .z) has more than 12 characters; 

the file cannot be opened; 

the file does not appear to be the output of pack. 

Unpack expands files created by pack. For each file name specified in the command, a search is 
made for a file called name.z (or just name, if name ends in .z). If this file appears to be a 
packed file, it is replaced by its expanded version. The new file has the .z suffix stripped from its 
name, and has the same access modes, access and modification dates, and owner as those of the 
packed file. 

Unpack returns a value that is the mmiber of files it was imable to impack. Failure may occur for 
the same reasons that it may in peat, as well as for the following: 

a file with the "unpacked" name already exists; 
if the unpacked file cannot be created. 

SEE ALSO 

cat(l). 
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NAME 

pam - Personal Applications Manager, a visual shell 

SYNOPSIS 

pam [ -c args ... ] 

DESCRIPTION 

Pam is a program that helps provide a friendlier, less intimidating means of communication 
between HP-UX and system users. It provides many of the traditional capabilities supported by 
other shell programs such as executing commands as foregroimd processes (where you must wait 
until one command has been completed before the system accepts the next command) or back- 
ground processes (where the command nms in the backgroimd while you perform other tasks in 
the foreground). Pam also supports other useful capabilities such as using substituted files instead 
of standard input and standard output, pipelining several processes into a single command, and 
handling shell scripts and programs. Pam maintains a continuous display of the open folder 
(ciurent directory), and makes use of windowing and mouse I/O facilities when they are available 
on the system. 

Display 

The pam display has two parts. The top two lines are called the command area, while the 
remainder of the display is the folder (directory) area. The first line in the command area 
displays messages (such as prompts and errors) from the system to the user, while the second 
line displays input conmiands and text from the user to the system. Pam maintains a buffer 
of 20 command lines. You can use shifted arrow keys, BACK SPACE, INSERT CHARACTER, and 
DELETE CHARACTER to access and edit any existing current or previous command line in the 
20-line command buffer. For example, each time you press SHIFT-UP ARROW, the next previ- 
ous command line in the buffer is displayed. 

The folder (lower) area is used by pam to display those files that reside in the currently open 
folder; that is, the cvurent directory. One of the file names displayed in the folder area is 
highlighted. This highlighted filename identifies which file in the folder is to be used as a 
filename parameter for pam conunands that are invoked using the pam menu. The highlighted 
file name can be changed by using TAB, SHIFT-TAB and arrow keys. 

Commands 

A command is a sequence of non-blank words separated by blanks. In general, the first word 
is the name of the command, and the words that follow are passed as arguments to the 
invoked command. Two or more commands (together with their associated arguments, if any) 
separated by a vertical bar ( I ) form a pipeline. To provide a path for passing data between 
commands in a pipeline, the standard output from one command in the pipeline is connected 
to the standard input of the next command in the pipe. 

To force pam to complete execution of the current command or pipeline before running 
another command, place a semicolon (;) at the end of the line. If you prefer to perform other 
tasks while the command or pipeline is being executed, run the first command as a "back- 
groimd" process by adding an ampersand (&) at the end of the command line. Pam then 
starts the conamand, and, without waiting for completion, returns for your next instruction. 

In a windowed system, interactive command inputs are treated as background processes ( & ) 
unless a semicolon is present at the end of the line. In non-windowed systems, commands 
taken from a script or from interactive command inputs are run to completion before the next 
command is accepted for execution ( ; ) unless an ampersand is present at the end of the com- 
mand line. 

Sequences of more than one command or pipeline can be joined on a single command line by 
placing a semicolon or ampersand (but not both) between each adjacent pair of 
commands/pipelines in the line. In such constructs, commsinds separated by ";" are executed 
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in sequence (the first command is run to completion before the next is begim). Conmiands 
separated by "&" are executed simultaneously on a timesharing basis (this does not necessarily 
result in the most efficient use of computer resources due to timesharing overhead as shairing 
processes compete for processor time). Note that when ";" or "&" is used to separate com- 
mands, standard output from one command is not automatically connected to standard input 
for the next. Use the pipeline connector ( I ) instead when data must be passed between suc- 
cessive commands or programs, or redirect standard output £uid input to and from a specified 
file. 

Pam nms commands based on the file type of the command name: 

program (executable) - The command name is rim (exec'ed) or, if it is a shell script, 
the commands in the script are run. 

folder (directory) - The command name (folder) becomes the new open folder. 

This is equivalent to cd folder. 

data (non-executable) - The commemd name (data file) is displayed one page at a 
time. 

Standard Input, Output, and Error Files 

The standard input, output and error of a command can be redirected using the following syn- 
tax: 

< name Use the file name as standard input for the command. 

> name Use the file name as standard output for the command. 

>> name Use the file name as standard output for the command, but concatenate 
the output to the end of the file. 

name Use the file name as standard error for the command. 

name Use the file name as standard error for the command, but concatenate the 
output to the current end of the file, if it exists. 

# name [For windowed systems only] Use the named window as standard input, 

output and error for the command. If the window doesn't exist then a 
window is created. Specific redirection of I/O with >, >>, <, I, ", or 
overrides any redirection specified with "#". 

I/O redirection is possible only with an associated command. Multiple redirections of standard 
input, output, and error associated with a command are not allowed. The I/O redirection can 
be placed anywhere in the command. 

If a command is followed by "&c" (background process), the default standard input for the 
command is the empty file "/dev/nuU". 

Using Patterns to Represent Filenames 

Each word in the command line (command name, parameter, redirection file name, window 
name) is scanned for the characters *, ?, and [. If one of these ch2iracters appears, the word is 
treated as a pattern that represents more than one filename. Pam replaces the pattern word 
with alphabetically sorted filenames corresponding to the pattern. If no file name is found that 
matches the pattern, the word is left unchanged. A period character ( . ) at the start of a 
filename or immediately following a /, as well as the character / itself, must be matched expli- 
citly. 

* Matches any string, including the null string. 
? Matches any single chciracter. 
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[...] Matches any one of the enclosed characters. A pair of characters separated by - 
matches any character lexically between the pair, inclusive. A NOT operator, !, 
can be specified immediately following the left bracket to match any single char- 
acter not enclosed in the brackets. 

Quoting 

Characters can be quoted on the pam conmiaiid line to prevent pam from performing special 
processing on the characters (such as <, >, #, space, I, ;, &, *, ?, [). A pair of double ( " ) or 
single ( ' ) quote characters can be used to enclose the character string being quoted. The \ 
character quotes only the single following charEicter. 

Scripts 

A script is an executable file containing command lines and comments. A conmient is a line, 
that begins with "!" or "#"; comments are ignored by pam. The command lines in the script 
file are executed in sequence (unless non-sequential execution is explicitely specified using the 
"&" character). 

Script arguments that are specified when a script is run can be accessed by script commands 
using the notation "$1" for the first argument, "$2" for the second argmnent, etc. All argu- 
ments can be accessed at once using "$*". The name of the script can be accessed using "$0". 

Autost 

If a file named Autost exists in the open folder when pam is started, it is automatically pro- 
cessed as a command. If Autost is a script file, it is run as source Autost (see Built-in Com- 
mands described later). Otherwise, it is processed as if it were entered as a command (for 
example, if Autost is a data file, it is viewed). Pam does not process any command input until 
processing of the Autost file is complete. 

Environment 

The pam environment is set up when pam is run, and can be reset at any time by using the 
command getenv. The environment variables are read from a file and are not sorted or 
checked for syntax by pam. Pam passes the current environment to conunands that it starts 
and uses the following environment variables in running commands: 

ACTION The ACTION variable specifies a command name (corresponding to 

an executable file), and is used whenever a data file is specified as a 
command. The ACTION command is run in this case and the data 
file is passed as the first argument. The default value for ACTION is 
"view". 

HOME The HOME variable specifies a folder and is used whenever the "cd ' 

conunand is nm without an argument. The HOME folder specifies 
the directory to change to in this case. The default value for HOME 
is "/". 

LANG The LANG variable is added by pam to its environment file if it is not 

already there. This happens when pam is initialized or when the 
getenv command is done. The value of the LANG variable is set to 
match the language that the system is localized for. 

PATH The PATH variable specifies a list of folders. When pam runs a com- 

mand it looks for it in the folders in the PATH list. 

SCRSHELL The SCRSHELL variable specifies the shell to be used by pam in run- 

ning scripts. If the specified name does not contain a "/" then pam 
searches for the shell using the PATH environment variable. If the 
SCRSHELL is undefined or the specified shell does not exist, the script 
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is processed by pam. 

Menu 

The pam menu displays the following softkey menu labels corresponding to the indicated func- 
tion keys: 

[function key 1] open, view, or start (a program), or reread 

[f2] echo 

[f3] send or arrow (toggle key) 

[f4] move 

[fS] copy 

[f6] rename 

[fr] delete 

[f8] close 

The command associated with a menu item is run whenever the item is selected by pressing 
the corresponding function key. The highlighted file name in the folder area of the display is 
used as a parameter for the conmiand. 

The menu item associated with f3 is used to toggle the semantics of the arrow keys and is 
available only in non-windowed systems. f3 is initially set to use the arrow keys for manipu- 
lating the position of the file highlight in the folder area. f3 alternately controls movement of 
the cursor on the command fine. 

Built-in Commands 

Several commands are executed directly by pam: 

cd [name] Make the named folder (directory) the open folder 

(current directory). If no folder is specified, the HOME 
environment variable is used to determine which folder to 
open. 

close Closes the open folder and displays the parent folder. 

copynameJ (nome;8] 

copy namel [name2 ...] folder— name 

Copy namel to name2; if exists and is not a folder, it is 
overwritten. If only namel is specified, the copy is com- 
pleted with the command foname2. If the last parameter 
specified is a folder, all the specified files are copied into 
that folder. 

delete namel [nameB ...] The named files and folders (if empty) are deleted. 

echo [arg ...] Arguments are written to standard output. The echo 

menu item (menu item 2 and/or function key 2) writes 
the full pathnjime of the highlighted file in the folder area 
of the display to the command line. 

getenv name The named file is read in and used as the active environ- 

ment. 

makefolder namel [name2 ...] 

Folders are created and given the specified name(s). 

move namel [name2] 

move namel [name2] folder^name 

Rename file or folder namel to name2. If name2 exists 
and is a file, it is overwritten. If only namel is specified, 
use the command to name 2 to complete the move. If the 
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last parameter is a folder, all the specified files are moved 



lllbU {jUaK, XUIUCI. 



netunam pathname {string\ 



print namel [name2 



Initiate a network connection to the specified system (as 
indicated by pathname) using the specified login (as indi- 
cated by string). If string is omitted, the network connec- 
tion to the specified system, if currently active, is discon- 
nected. 

Print the specified files on the designated system printer. 



rename namel [name2] 

rename file— namel [file—name2 ...] folder— name 
Same as move. 



reread 



send 



source name [arg 



stopprint 



to [name] 



view namel [name2 ...] 



Reread the open folder and update the display. The keys- 
troke CONTROL-L also does a reread. 

Send the full pathname of the highlighted filename in the 
folder area to an application as if it were typed from the 
keyboard (windowed systems only). 

Read command lines from the named script file and exe- 
cute them. A shell is NOT forked to execute the com- 
mands. Parameter substitution for the arguments {arg 
...) is handled the same way as during regular script exe- 
cution. 

Stop current printing activity if it was started by the 
print command. 

Complete a pending copy, move or rename. The file or 
folder name identifies the destination for a preceding 
copy, move, or rename command that had no destina- 
tion specified. If name is omitted, the destination defaults 
to the current open folder. 

Copy the specified file(s) to standard output. If standard 
output is the screen (default), the file is displayed one 
page at a time. 



Signals 

Pam ignores INTERRUPT «md QUIT signals if the command is followed by £in "&"; other- 
wise pam uses default signal handling when running commands. 

Invoking Pam 

Pam can be invoked as a keyboard command or from a program. When pam is invoked 
without -c as the first argtunent, pam acts as an interactive, display-oriented command 
interpreter. 

When pam is invoked with -c as the first argument (either from the keyboard or from a 
running program), the remaining arguments in the command are interpreted as conunand 
inputs intended for processing by pam. The list of arguments intended as commands for 
pam must not exceed a total of 160 characters. When the -c option is used, pam executes 
the list of command arguments (built-in conmiands, redirection, pipes, and most other pam 
facilities can be used), then exits. 
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Exiting from Pam 

To terminate pam and return to normal HP-UX operation, press CONTROL D or 
CONTROL-C. 

HARDWARE DEPENDENCIES 

With a non-windowed pam running on certain terminals the shifted right and left arrow keys can- 
not be used to move the cursor on the command line. 

IPC: pam runs commands with the SIGHUP signal ignored. 

The netunam built-in command is not supported. 

Series 300/500: The built-in commands print, stopprint, and send are not supported. 
The environment variable LANG is not set up by pam. 

FILES 

/rom/PAM 

/rom/.environ 

/tmp/Plock 

Autost 

/rom/PAMmsg 

/usr/lib/nls/n-computer/pam.cat 

/dev/null 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd [ name ] 

DESCRIPTION 

This command changes or installs a password associated with the login name. If name is omitted, 
it defaults to getlogin{3C) name. 

Ordinary users may change only the password which corresponds to their login name. 

Passwd prompts ordinary users for their old password, if any. It then prompts for the new pass- 
word twice. The first time the new password is entered passwd checks to see if the old password 
has "aged" sufficiently. If "aging" is insufficient the new password is rejected and passwd ter- 
minates; see passwd{4). 

Assuming "aging" is sufficient, a check is made to insure that the new password meets construc- 
tion requirements. When the new password is entered a second time the two copies of the new 
password are compared. If the two copies are not identical the cycle of prompting for the new 
password is repeated for at most two more times. 

Passwords must be constructed to meet the following requirements: 

Each password must have at least six characters. Only the first eight characters are 
signific£int. 

Each password must contain at least two alphabetic chsuracters and at least one nmneric 
or special character. In this case, "alphabetic" means upper and lower case letters. 

Each password must differ from the user's login name and any reverse or circular shift of 
that login name. For comparison purposes, an upper case letter and its corresponding 
lower case letter are equivalent. 

New passwords must differ from the old by at least three characters. For comparison 
purposes, an upper case letter and its corresponding lower case letter are equivalent. 

One whose effective user ID is zero is called a super-user; see «d(l), and a«(l). Super-users may 
change any password; hence, passwd does not prompt super-users for the old password. Super- 
users are not forced to comply with password aging and password construction requirements. A 
super-user can create a null password by entering a carriage return in response to the prompt for 
a new password. 

FILES 

/etc/passwd 

SEE ALSO 

id(l), login(l), su(l), crypt(3C), passwd(4). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, messages. 
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NAME 

paste - merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste filel file2 . . . 
paste -dlist filel file2 ... 
paste -a^ [-dlist] filel file2 ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the given input files filel, file2, 
etc. It treats each file as a column or columns of a table and pastes them together horizontally 
(parallel merging). U you will, it is the counterpart of cat{l) which concatenates vertically, i.e., 
one file after the other. In the last form above, paste replaces the function of an older command 
with the same name by combining subsequent lines of the input file (serial merging). In all cases, 
lines are glued together with the tab character, or with characters from an optionally specified list. 
Output is to the standard output, so it can be used as the start of a pipe, or as a filter, if - is 
used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each but the last file (or last line 

in case of the s option) are replaced by a tab character. This option allows 
replacing the tab character by one or more alternate characters (see below). 

list One or more characters immediately following -d replace the default tab as the 

line concatenation character. The list is used circularly, i.e., when exhausted, it 
is reused. In parallel merging (i.e., no s option), the lines from the last file are 
always terminated with a new-line character, not fi:om the list. The list may 
contain the special escape sequences: \n (new-line), \t (tab), \\ (backslash), 
and \0 (empty string, not a null character). Quoting may be necessary, if char- 
acters have special meaning to the shell (e.g., to get one backslash, use -d"\\\\" 
)• 

-9 Merge subsequent lines rather than one from each input file. Use tab for con- 

catenation, unless a list is specified with -d option. Regardless of the list, the 
very last character of the file is forced to be a new-line. 

- May be used in place of any file name, to read a line from the standard input. 

(There is no prompting). 

EXANfPLES 

Is I paste -d" " - list directory in one colmnn 

Is ) paste list directory in four coltunns 

paste -s -d"\t\n" file combine pairs of lines into lines 

SEE ALSO 

cut(l), grep(l), pr(l). 

NOTES 

pr -t -m. . . works similarly, but creates extra blanks, tabs and new-lines for a nice page layout. 

DIAGNOSTICS 

line too long Output lines are restricted to 511 characters. 

too many files Except for -8 option, no more than 12 input files may be specified. 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

ptathalias - electronic address router 

SYNOPSIS 

pathalias [ -icv ] [ -1 host ] [ -d arg ] ( -t arg ] [ files ] 

DESCRIPTION 

Pathaliaa computes the shortest paths and correspondmg routes from one host (computer system) 
to all other known, reachable hosts. Pathaliaa reads host-to-host connectivity information on 
standard input or in the named files, and writes a list of host-route pairs on the standard output. 

Options are: 

-i Ignore case: map all host names to lower case. By default, case is significant. 

-c Print costs: print the path cost (see below) before each host-route pair. 

-V Verbose: report some statistics on the standard error output. 

-I host 

Set local host name to host. By default, pathaliaa discovers the local host name in a 
system-dependent way. 

-d arg 

Declare a dead link, host, or network (see below). If arg is of the form "hostl!host2," the 
link from hostl to host2 is treated as an extremely high cost {i.e., DEAD) link. If arg is a 
single host name, that host is treated as dead and is used as an intermediate host of last 
resort on any path. If arg is a network name, the network requires a gateway. 

-t arg 

Trace input for link, host or network on the standard error output. The form of arg is as 
above. 

The pubhc domain version of pathalias includes two undocumented options, that are briefly 
described in the Special Options section below. 

Input Format 

A Ime beginning with white space continues the preceding line. Anything following '#' on an 
input line is ignored. 

A list of host-to-host connections consists of a "from" host in coliunn 1, followed by white space, 
followed by a comma-separated list of "to' hosts, called links. A link may be preceded or followed 
by a network character to use in the route. Valid network characters are '!' (default), '@', ':', and 
'%'. A link (and network character, if present) may be followed by a "cost" enclosed in 
parentheses. Costs may be arbitrary arithmetic expressions involving nimibers, parentheses, '+', 
'-', '*', and 7'. The following symbolic costs are recognized: 

LOCAL 25 (local-area network connection) 

DEDICATED 95 (high speed dedicated Imk) 

DIRECT 200 (toll-free call) 

DEMAND 300 (long-distance call) 

HOURLY 500 (hourly poll) 

EVENING 1800 (time restricted call) 

DAILY 5000 (daily poll, also called POLLED) 

WEEKLY 30000 (irregular poll) 

In addition, DEAD is a very large mmiber (effectively infinite), and HIGH and LOW are -5 and -1-5 
respectively, for baud-rate or quality bonuses/i)enalties. These symbolic costs represent an imper- 
fect measure of bandwidth, monetary cost, and frequency of connections. For most mail traflBc, it 
is important to minimize the number of intermediaries in a route, thus, e.g., HOURLY is far 
greater than DAILY / 24. If no cost is given, a default of 4000 is used. 
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For the most part, arithmetic expressions that mix symbolic constants other than HIGH and LOW 
make no sense. For example, if a host calls a local neighbor whenever there is work, and addition- 
ally polls every evening, the cost is DIRECT, not DIRECT+EVENING. 

Some examples: 

down Princeton! (DEDICATED), tilt, 

%thrash(LOCAL) 
Princeton topaz! (DEMAND+LOW) 

topaz @rutger8(L0CAL) 

If a link is encoimtered more than once, the least-cost occurrence dictates the cost and network 
character. Links are treated as bidirectional, to the extent that a DEAD reverse link is assmned 
miless better information is available. 

The set of names by which a host is known by its neighbors is called its aliases. Aliases are 
declared as follows: 

name = alias, alias ... 

The name used in the route to or through aliased hosts is the name by which the host is known to 
its predecessor in the route. 

Fully connected networks, such as the ARPANET or a local-area network, are declared as follows: 

net = {host, host, ...} 

The host-list may be preceded or followed by a routing character, and may be followed by a cost: 

princeton-ethemet = {down, up, princeton}! (LOCAL) 
AREA = @{sri-unix, mit-ai, su-score} (DEDICATED) 

The routing character used in a route to a network member is the one encountered when "enter- 
ing" the network. See also the sections on gateways smd domains. 

Connection data may be given while hiding host names by declaring 

private {host, host, ...} 

Pathalias will not generate routes for private hosts, but may produce routes through them. The 
scope of a private declaration extends from the declsiration to the end of the input file in which it 
appears. It is best to put private declarations at the beginning of the appropriate input file. 

Output Format 

A list of host-route pairs is written to the standard output, where route is a string appropriate for 
use with print/(3S), e.g., 

rutgers princeton!topaz!%s@rutgers 

The "%s" in the route string should be replaced by the user name at the destination host. (This 
task is normally performed by a mailer.) 

Except for domains (see below), the name of a network is never used in expansions. Thus, in the 
earlier example, the path from down to up would be "up!%s," not "princeton-ethemet!upl%s." 

Gateways 

A network is represented by a pseudo-host and a set of network members. Links from the 
members to the network have the weight given in the input, while the cost from the network to 
the members is zero. If a network is declared dead on the conunand line (with the -d option), the 
member-to-network links are marked dead, which discourages paths to members by way of the 
network. 

If the input also shows a link from a host to the network, then that host will be preferred as a 
gateway. Gateways need not be network members. 
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For example, suppose CSNET is declared dead on the command line and the input contains 

CSNET = {...} 

csnet-relay CSNET 

Then routes to CSNET hosts will use csnet-relay as a gateway. 

Domains 

A host or network whose name begins with '.' is called a domain. Domains are presiuned to 
require gateways, i.e., they are DEAD. The route given by a path through a domain is similar to 
that for a network, but here the domain name is tacked onto the end of the next host. Sub- 
domains are permitted. For example, 

harvard .EDU 

.EDU = {.BERKELEY} 
.BERKELEY ernie 

yields 

ernie ...!harvard!emie.BERKELEY.EDU!%s 

Output is given for the nearest gateway to a domain, e.g., the example above gives 

.EDU ...!harvard!%s 

Special Options 

The public domain version of pathalias includes two imdocumented options that rewrite named 
files with intermediate data of limited usage. Here are brief descriptions: 

-g file Dump graph edges into file in the form "host>ho8t" for simple connections and 

"host@<tab>host" for network connections (from hosts to networks only). 

-B file Dump shortest path tree into file in the form "host<tab>[@]host[!](cost)", 

including both connections from hosts to networks and from networks to hosts. 
This data may be useful for generating lists of one-way connections. 

BUGS 

The -i option should be the default. 

The order of arguments is significant. In particular, -i and -t should appear early. 

Pathalias can generate hybrid (i.e. ambiguous) routes, which £ire abhorrent and most certainly 
should not be given as examples in the manual entry. 

Multiple '@'s in routes are prohibited by many mailers, so pathalias resorts to the "magic %" rule 
when appropriate. This convention is not documented anywhere, including here. 

AUTHOR 

Pathalias was developed by Peter Honeyman and Steven M. Bellovin. 

FILES 

newsgroup mod.map Likely location of some input files. 
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NAME 

pc - Pascal compiler 

SYNOPSIS 

pc [ options ] files 

REMARKS 

This manual page describes the generic HP Pascal compiler; implementation dependencies for 
different machines are noted as needed. 

DESCRIPTION 

Pc is the HP standard Pascal compiler. It accepts several tjrpes of file argmnents: 

(1) Arguments whose names end with .p are taken to be Pascal source files. They are each 
compiled, and each corresponding object program or module(s) is left in the current direc- 
tory in a file whose name is that of the source, with .o substituted for .p. The .o file will be 
immediately deleted (leaving only the linked executable file) if only a single source is com- 
piled and linked, if the -C option is specified, or if the source fails to compile correctly. 

(2) All other file arguments, including those whose names end with .o or .a, are passed on to 
the linker {ld{l)) to be linked into the final program. 

Argimients can be passed to the compiler through the PCOPTS environment variable as well as 
on the command line. The compiler picks up the value of PCOPTS and places its contents before 
any argmnents on the command line. For example (in sh{l) notation), 

$ PCOPTS=-v 
$ export PCOPTS 
$ pc -L prog.p 

is equivalent to 

$ pc -V -L prog.p 

Options 

The following options are recognized: 

-A Produce warnings for the use of non-ANSI-Pascal features. (Same as 

lANSI ONt). 

-C Suppress code generation. No .o files will be created and linking will be 

suppressed. This is effectively a request for syntax/semantic checking only (same 
astCODE OFF$). 

-c Suppress linking and only produce object (.o) files from soTirce files. 

-g Generate additional information needed by a symbolic debugger, and ensure that 

the program is linked as required. See the appropriate implementation reference 
manual for more information on symbolic debugging support. 

-L Write a program listing to stdout (see the HARDWARE DEPENDENCIES sec- 

tion below for exceptions). 

-Ix Cause the linker to search first in the library named /lib/Ubi.a and then in 

/u8r/lib/libz.a (see W(l)). 

-N Cause the output file from the linker to be marked as imshareable (see -n). For 

details and system defaults, refer to the linker documentation (W(l)). 

-n Cause the output file from the linker to be marked as shareable (see -N). For 

details and system defaults, refer to the linker docmnentation {ld{l)). 

-o outfile Name the output file from the linker outfile instead of a.out. 
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— P lines Specifies the number of lines (including any header or trailer) which should be 

listed per page of generated listing (same as $LINES n$). 

-Q Cause the output file from the linker to be marked as not demand loadable (see 

-q). For details and system defaults, refer to the linker documentation (W(l)). 

-q Cause the output file from the linker to be marked as demand loadable (see -Q). 

For detiuls and system defaults, refer to the linker dociunentation {ld{l)). 

-8 Cause the output of the linker to be stripped of symbol table information (see 

W(l) and strip{l)). (This option is incompatible with symbolic debugging.) 

-t c,name Substitute or insert subprocess c with name where c is one or more of an 

implementation-defined set of identifiers indicating the subproces8(es). This 
option works in two modes: 1) if c is a single identifier, name represents the full 
pathname of the new subprocess; 2) if c is a set of (more than one) identifiers, 
name represents a prefix to which the standard suffixes are concatenated to con- 
struct the full path name of the new subprocesses. 

The values c can assimie are: 

c compiler body (standard suffix is pascomp) 

same as c 

1 linker (standard suffix is Id) 

—V Enable verbose mode, producing a step-by-step description of the compilation 

process on stderr. 

-w Suppress warning messages (same as $WARN OFF$). 

-W c,argl[,arg2,...,argN\ 

Cause argl through argN to be handed off to subprocess c. The argi are of the 
form -argoption[,argvalue], where argoption is the name of an option recognized 
by the subprocess and argvalue is a separate argument to argoption where neces- 
sary. The values that c can assume are those listed under the -t option, as well 
as the value d (driver program), which has a special meaning explained below. 

For example, the specification to pass the -r (preserve relocation information) 
option to the linker would be: 

-W 1,-r 

The -W d option specification allows additional, implementation-specific options 
to be recognized and passed through the compiler driver to the appropriate com- 
piler subprocesses. For example, on Series 500: 

-W d,-U 

will send the option -U to the driver and compiler. Furthermore, a shorthand 
notation for this mechanism can be used by prepending -|- to the option name; as 
in 

+U 

which is equivalent to the previous option expression. Note that for simplicity 
this shorthand is applied to each implementation-specific option individually, and 
that the argvalue is no longer separated from the argoption by a comma (see 
-W). 

HARDWARE DEPENDENCIES 

Series 200, 300, 500: 
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The following option is supported: 

-Y Enable 16-bit Native Language Support when parsing string literals and com- 

ments (same as $NLS_SOURCE$). Note that 8-bit parsing is always sup- 
ported. 

Series 200, 300 and Integral PC: 

The -L option writes a program listing to the file given in the $LIST fllenameS option 
in the source, instead of to stdout. 

The following option is implemented only on the Series 200, 300 and the Integral PC: 

-|-a Cause the compiler to generate archived object (.a) files instead of simple 

object (.o) files. This allows source files containing multiple HP Pascal 
modules to be compiled such that each module can be linked independently. 
Use of this option is discouraged for portability reasons. It is provided to 
facilitate migration from Series 200 HP-UX releases prior to Release 5.1 (where 
•a files were always generated), to 5.1 and subsequent releases. Otherwise, it 
is recommended that modules needing separate linkability be placed in 
separate source files. To facilitate use of previously existing makefiles and 
scripts that depended on the archive generation, the PCOPTS environment 
variable can be used (e.g., set PCOPTS="+a $PCOPTS"). 

Series 200, 300: 

The following options are implemented only on the Series 200 and 300: 

-|-A Cause the compiler to always use 2-byte data and stack alignment rules 

instead of default 4-byte aligimient rules for stacks and data objects exceeding 
four bytes when generating object code for MC68020 systems (see reference 
manual and -|-x option below for more details). 

-fX Cause the compiler to generate "generic" MC68010 code. The code can also 

run on an MC68020 microprocessor, but cannot use its expanded capabilities. 

-|-x Cause the compiler to generate code that utilizes the expanded capabilities of 

the MC68020 and generates in-line code for the MC68881. 

-|-M Cause the compiler not to generate inline code for the MC68881 floating-point 

coprocessor. Library routines will be referenced for math and intrinsic opera- 
tions. This option is meaningless on MC68010 based systems or in conjimction 
with -HX. 

Series 500: 

The following options are not supported: -b, -e, and -f. 

The following options must be specified with the -W d,... option or the -|- shorthand: 
-E, -F, -H [bytes], and -W [bytes]. 

The following options are implemented only on the Series 500: 

-|-E Cause the program to be linked with the library /lib/libpcesc.a, which 

transforms all execution errors (HP-UX signals, Pascal nm-time errors, Pascal 
I/O errors and HP-UX errors) into escapes. This differs from the default 
library /lib/libpccat.a, which prints the appropriate error message and 
aborts the program. 

-|-F Cause the compiler to generate information for use by various program 

analyzers. 

-I-H [bytes] 

Display (if bytes is omitted) or set a Pascsil program's maximum heap size. 
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Bytes is the maxinram number of bytes in the heap. 

-|-Q dfile Cause dfile to be read before compilation of each soiu-ce file. Dfile may only 
contain compiler options. 

+U Cause the compiler to upshift externally visible names. Default is lowercase 

(same as $UPSHIFT_LEVEL1 ON$). 

+W [bytes] 

Display (if bytes is omitted) or set a Pascal program's working set size. Bytes 
is the number of bytes in the program's working set. 

To use the +H or -|-W options on an executable file other than a.out, the file to be 
examined (modified) must be specified with the -o option. For example, to set the heap 
of program foo to 1000000, use: 

pc +H 1000000 -o foo 

do not use: 

pc +H 1000000 -W l,-o,foo 



Series 800: 



The following options are not supported: -P, -t, -w. 

The following option is implemented only on the Series 800: 



FILES 



+Oopt 



file.p 
file.a 

file.o 

a.out 

/usr/lib/pascomp 

/usr/lib/paserrs 

/usr/lib/escerrs 

/usr/lib/syserrs 

/usr/lib/ioerrs 

/lib/crtO.o 

/hb/prtO.o 

/lib/libpc.a 

/lib/libcl.a 

/lib/libm.a 

/lib/libpccat.a 

/lib/libpcesc.a 

/lib/libc.a 

/usr/tmp/* 



Invoke optimizations selected by opt. If opt is '1', then only level 1 optimiza- 
tions are handled. If opt is '2', then all optimizations are performed. The 
option +02 is the same as -O. 

input file (Pascal source file) 

any archive file to be searched at link time (or for the Series 200, Series 300, 

and Integral PC only, optionally generated object archive file) 

compiler-generated or other object file that is to be relocated at link time 

linked executable output file 

compiler 

compiler error message file 

Pascal escape codes (Series 200, Series 300, and Integral PC only) 

HP-UX system messages (Series 200, Series 300, and Integral PC only) 

Pascal I/O results (Series 200, Series 300, and Integral PC only) 

runtime startup (except Series 500) 

runtime startup (Series 500 only) 

Pascal run-time library (except Series 800) 

Pascal nm-time library (Series 800 only) 

HP-UX math library (Series 200, Series 300, and Integral PC only) 

Pascal run-time library, reports errors and aborts program (Series 500 only) 

Pascal nm-time library, translates errors into escapes (Series 500 only) 

HP-UX system hbrary (C-language library) 

temporary files used by the compiler; names are created by tmpnam{3S). 



SEE ALSO 

HP Pascal Language Reference for Series 200, Series 300 (also valid for Integral PC). 

Pascal/9000 Language Reference Manual, for Series 500. 

Programming in Pascal with Hewlett-Packard Pascal, by Peter Grogono. 
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DIAGNOSTICS 

The diagnostics produced by pc are intended to be self-explanatory. Occasional messages may be 
produced by the linker. 

A list of all compiler errors may be found in /usr/lib/paserrs. 

If a listing is requested (-L option), errors are written to the listing file {stdout). If a listing is 
requested and either or both of atdout/atderr has been redirected to something other than a termi- 
nal, errors will also be written to stderr. If no listing is requested (no -L option), errors are writ- 
ten to stderr. This effectively guarantees that stderr will always receive error messages, tmless that 
would result in duplication of error messages printed on the terminal. 

INTERNATIONAL SUPPORT 

8- and 16-bit data only in strings and comments, 8-bit filenames. 
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NAME 

pg - file perusal filter for soft-copy termiiials 

SYNOPSIS 

pg [-number] [-p string] [-cefhs] [+linenumber] [+/pattern/] [files...] 

REMARKS 

The decryption facilities provided by this software are tinder control by the United States Govern- 
ment and cannot be exported without special licenses. These capabilities can be sold only to 
domestic customers at this time. 

DESCRIPTION 

The pg command is a filter which allows the examination of files one screenful at a time on a 
soft-copy terminal. (The file name - and/or NULL arguments indicate that pg should read from 
the standard input.) Each screenful is followed by a prompt. If the user types a carriage return, 
another page is displayed; other possibilities are enumerated below. 

This command is different from previous paginators in that it allows you to back up and review 
something that has already passed. The method for doing this is explmned below. 

In order to determine terminal attributes, pg scans the terminfo{4) data base for the terminal 
type specified by the environment variable TERM. If TERM is not defined, the terminal type 
dumb is assumed. 

The command line options are: 

-number An integer specifying the size (in lines) of the window that pg is to use instead of 

the default. (On a terminal contsuning 24 lines, the default window size is 23). 

-p string Causes pg to use string as the prompt. If the prompt string contains a "%d", 

the first occurrence of "%d" in the prompt will be replaced by the cturent page 
niunber when the prompt is issued. The default prompt string is ":". 

-c Home the cursor and clear the screen before displaying each page. This option is 

ignored if clear_screen is not defined for this terminal type in the terminfo{4) 
data base. 

-e Causes pg not to pause at the end of each file. 

-f Normally, pg splits lines longer than the screen width, but some sequences of 

characters in the text being displayed (e.g., escape sequences for underlining) 
generate imdesirable results. The -/option inhibits pg from splitting lines. 

-n Normally, commands must be terminated by a <newline> character. This 

option causes an automatic end of command as soon as a command letter is 
entered. 

-8 Causes pg to print all messages and prompts in standout mode (usually inverse 

video). 

+linenumber Start up at linenumber. 

•\- 1 pattern I Start up at the first line containing the regular expression pattern. 

Pg looks in the environment variable PG to pre-set any flags desired. For example, if you prefer 
to view files using the -c mode of operation, the shell conunand sequence PG='-c' ; export PG or 
the csh conunand setenv PG -c would cause all invocations of pg, including invocations by pro- 
grams such as man and msgs, to use this mode. Normally, the user will place the command 
sequence which sets up the PG environment variable in the .profile or .cshrc file. 

The responses that may be typed when pg pauses can be divided into three categories: those caus- 
ing further perusal, those that search, and those that modify the perusal environment. 
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Commands which cause further perusal normally take a preceding address, an optionally signed 
number indicating the point from which further text should be displayed. This address is inter- 
preted in either pages or lines dei)ending on the command. A signed address specifies a point rela- 
tive to the current page or line, and an imsigned address specifies an address relative to the begin- 
ning of the file. Each conamand has a default address that is used if none is provided. 

The perusal commands and their defaults are as follows: 

{+l)<newline> or <blank> 

This causes one page to be displayed. The address is specified in pages. 

(-1-1) 1 With a relative address this causes pg to simulate scrolling the screen, forward or 

backward, the number of lines specified. With an absolute address this com- 
mand prints a screenful beginning at the specified line. 

(-1-1) d or *D Simulates scrolling half a screen forward or backward. 

The following perusal commands take no address. 

. or *L Typing a single period causes the ciurent page of text to be redisplayed. 

$ Displays the last windowful in the file. Use with caution when the input is a pipe. 

The following commands are available for searching for text patterns in the text. The regular 
expressions described in ed(l) are available. They must always be terminated by a <newline>, 
even if the -n option is specified. 

i/pattern/ 

Search forward for the tth (default i=l) occurrence of pattern. Searching begins immedi- 
ately after the current page and continues to the end of the current file, without wrap- 
around. 

{'pattern' 

ilpatternl 

Search backwards for the tth (default »=1) occurrence of pattern. Searching begins 
immediately before the current page and continues to the beginning of the current file, 
without wrap-£iround. The ' notation is useful for Adds 100 terminals which will not 
properly handle the ?. 

After searching, pg will normally display the line foimd at the top of the screen. This can be 
modified by appending m or b to the search command to leave the line foimd in the middle or at 
the bottom of the window from now on. The suffix t can be used to restore the original situation. 

The user of pg can modify the environment of perusEil with the following commands: 

tn Begin perusing the ith next file in the command line. The t is an imsigned number, 

default value is 1. 

tp Begin perusing the ith previous file in the command line, i is an unsigned niunber, 

default is 1. 

iw Display another window of text. If i is present, set the window size to i. 

s filename 

Save the input in the named file. Only the current file being perused is saved. The white 
space between the s and filename is optional. This command mtist always be terminated 
by a <newl%ne>, even if the -n option is specified. 

h Help by displaying an abbreviated siunmary of available commands. 

q or Q Quit pg. 

\command 

Command is passed to the shell, whose name is taken from the SHELL environment 
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variable. If this is not available, the default shell is used. This commeaid must Eilvvayo be 
terminated by a <newline>, even if the -n option is specified. 

At any time when output is being sent to the terminal, the user can hit the quit key (normally 
control-\) or the interrupt (break) key. This causes pg to stop sending output, and display the 
prompt. The user may then enter one of the above commands in the normal manner. Unfor- 
tunately, some output is lost when this is done, due to the fact that any characters waiting in the 
terminal's output queue are flushed when the quit signal occurs. 

If the standard output is not a terminal, then pg acts just like cat{l), except that a header is 
printed before each file (if there is more than one). 

EXAMPLE 

A sample usage of pg in reading system news would be 

news I pg -p "(Page %d):" 

NOTES 

While waiting for terminal input, pg responds to BREAK, DEL, and " by terminating execution. 
Between prompts, however, these signals interrupt py's current task and place the user in prompt 
mode. These should be used with caution when input is being read from a pipe, since an interrupt 
is likely to terminate the other commands in the pipeline. 

Users of Berkeley's more will find that the z and f commands are available, and that the terminal 
/, *, or ? may be omitted from the searching commands. 

FILES 

/usr/lib/terminfo/?/* Terminal information data base 
/tmp/pg* Temporary file when input is from a pipe 

SEE ALSO 

cr3rpt(l), ed(l), grep(l), terminfo(4). 

BUGS 

If terminal tabs are not set every eight positions, imdesirable results may occur. 

When using pg as a. filter with another command that changes the terminal I/O options (e.g., 
crypt{l)), terminal settings may not be restored correctly. 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

pr - print files 

SYNOPSIS 

pr [ options ] [ files ] 

DESCRIPTION 

Pr prints the named files on the standard output. If file is -, or if no files are specified, the stan- 
dard input is assumed. By default, the listing is separated into pages, each headed by the page 
number, a date and time, and the name of the file. 

By default, colmnns are of equal width, separated by at least one space; lines which do not fit are 
truncated. If the -s option is used, lines are not tnmcated and columns are separated by the 
separation character. 

If the standard output is associated with a terminal, error messages are withheld until pr has 
completed printing. 

The below options may appear singly or be combined in any order: 

-I- A: Begin printing with page A: (default is 1). 

-k Produce A-column output (default is 1). The options -« and -i are assmned for 

multi-column output. 

-a Print multi-colmnn output across the page. 

-m Merge and print all files simultaneously, one per coliunn (overrides the -k, and 

-a options). 

-d Double-space the output. 

-eck Expand input tabs to character positions k+1, 2*k+l, 3*fc+l, etc. If fc is or is 

omitted, default tab settings at every eighth position are assumed. Tab charac- 
ters in the input are expanded into the appropriate number of spaces. If c (any 
non-digit character) is given, it is treated as the input tab character (default for 
c is the tab character). 

-ick In output, replace white space wherever j)08sible by inserting tabs to chareicter 

positions k+1, 2*fc-|-l, 3*fc-|-l, etc. If A; is or is omitted, default tab settings at 
every eighth position are assimied. If c (any non-digit character) is given, it is 
treated as the output tab character (default for c is the tab character). 

—nek Provide fc-digit line numbering (default for k is 5). The number occupies the 

first fc-|-l character positions of each coliunn of normal output or each line of -m 
output. If c (any non-digit chareicter) is given, it is appended to the line niunber 
to separate it firom whatever follows (default for c is a tab). 

-v/k Set the width of a line to k character positions (default is 72 for equal- width 

multi-colimm output, no limit otherwise). 

-ok Offset each line by k character positions (default is 0). The nmnber of character 

positions per line is the sum of the width and offset. 

-Ik Set the length of a page to k lines (default is 66). 

-h Use the next argmnent as the header to be printed instead of the file name. 

-p Pause before beginning each page if the output is directed to a terminal {pr will 
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ring the bell at the te rmin al and wait for a carriage return). 

-f Use form-feed character for new pages (default is to use a sequence of line-feeds). 

Pause before beginning the first page if the standard output is associated with a 
terminal. 

-r Print no diagnostic reports on failure to open files. 

-t Print neither the five-line identifying header nor the five-line trailer normally 

supplied for each page. Quit printing after the last line of each file without spac- 
ing to the end of the page. 

-sc Separate columns by the single character c instead of by the appropriate niunber 

of spaces (default for c is a tab). 

EXAMPLES 

Print fllel and file2 as a double-spaced, three-column listing headed by "file list": 

pr -3dh "file list" filel file2 

Write filel on file2, expanding tabs to colmnns 10, 19, 28, 37, ... : 

pr -e9 -t <filel >file2 

FILES 

/dev/tty* to suspend messages 

SEE ALSO 

cat(l), lp(l), ul(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 



Hewlett-Packard Company - 2 - Version B.l, October 1986 



PREALLOC ( 1 ) HP-UX PREALLOC ( 1 ) 



NAME 

prealloc - preallocate disk storage 

SYNOPSIS 

prealloc name size 

DESCRIPTION 

Prealloc will preallocate at least size bytes of disk space for an ordinary file name of zero length. 
It will create the file if it does not already exist. The space will be allocated in an implementation 
dependent fashion for fast sequential reads and writes for the file. 

Prealloc will fail and no disk space will be allocated if name already exists and is not an ordinary 
file of zero length, if there is not enough space left on disk, or if size exceeds the maximum file size 
or the process' file size limit (see ulimit{2)). The EOF is left at the end of the preallocated area. 
The current file pointer is left at zero. The file is zero-filled. 

EXAMPLES 

The following example preallocates 50000 bytes for the file my file: 

prealloc myfile 50000 

DIAGNOSTICS 

Upon successful completion, prealloc exits with a status. Exit status is 1 if name already exists 
and is not an ordinary file of zero length, 2 if there is not enough room on disk, or 3 if size exceeds 
file size limits. 

AUTHOR 

Prealloc was developed by the Hewlett-Packard Company. 

SEE ALSO 

prealloc(2), ulimit(2) 

BUGS 

The allocation of the file space is highly dependent on the current disk usage. A successful retimi 
does not tell you how fragmented the file actually might be if the disk is reaching its capacity. 
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NAME 

prmail - print out mail in the post office 

SYNOPSIS 

prmail [ user ... ] 

DESCRIPTION 

Prmail prints the mail which waits for you, or the specified user, in the post office. The mail is 
not distm-bed. 

FILES 

/usr/mail/* post office 

AUTHOR 

Prmail was developed by the University of California, Berkeley. 

SEE ALSO 

from(l), mail(l). 
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NAME 

prof - display profile data 

SYNOPSIS 

prof [-tcan] [-ox] [-g] [-z] [-h] [-a] [-m mdata] [prog] 

DESCRIPTION 

Prof interprets a profile file produced by the monitor{iC) function. The symbol table in the 
object file prog (a.out by default) is read and correlated with a profile file (mon.out by default). 
For each external text symbol the percentage of time spent executing between the address of that 
symbol and the address of the next is printed, together with the number of times that function 
was called and the average niunber of milliseconds per call. 

The mutually exclusive options t, c, a, and n determine the type of sorting of the output lines: 

-t Sort by decreasing percentage of total time (default). 

-c Sort by decreasing nmnber of calls. 

-a Sort by increasing symbol address. 

-n Sort lexically by symbol name. 

The mutually exclusive options o and x specify the printing of the address of each symbol moni- 
tored: 

-o Print each symbol address (in octal) along with the symbol name. 

-x Print each symbol address (in hexadecimal) along with the symbol name. 

The following options may be used in any combination: 

-g Include non-global symbols (static functions). 

-z Include all symbols in the profile range (see monitor {iC)), even if associated with zero 

number of calls and zero time. 

-h Suppress the heading normally printed on the report. (This is useful if the report is to be 

processed further.) 

-8 Print a summary of several of the monitoring parameters and statistics on the standard 

error output. 

-m mdata 

Use file mdata instead of mon.out as the input profile file. 

A program creates a profile file if it has been loaded with the -p option of cc(l). This option to 
the cc command arranges for ceills to monitor{ZC) at the begiiming and end of execution. It is 
the call to monitor at the end of execution that causes a profile file to be written. The nmnber of 
calls to a function is tallied if the -p option was used when the file containing the function was 
compiled. 

The name of the file created by a profiled program is controlled by the environment variable 
PROFDIR. If PROFDIR does not exist, "mon.out" is produced in the directory current when the 
program terminates. If PROFDIR = string, "string/pid.progname" is produced, where progname 
consists of argv[0] with any path prefix removed, and pid is the program's process id. If PROFDIR 
= nothing, no profiling output is produced. 

A single function may be split into subfunctions for profiling by means of the MARK macro (see 
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prom). 

FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

cc(l), tplot(l), exit(2), profil(2), monitor(3C), prof(5). 

WARNING 

The times reported in successive identical runs may show variances of 20% or more, because of 
varying cache-hit ratios due to sharing of the cache with other processes. Even if a program 
seems to be the only one using the machine, hidden background or asynchronous processes may 
blur the data. In rare cases, the clock ticks initiating recording of the program coimter may 
"beat" with loops in a program, grossly distorting measm-ements. 

Call coimts are always recorded precisely, however. 



BUGS 



Only programs that call exit{2) or return from main will cause a profile file to be produced, imless 
a final call to monitor is explicitly coded. 

The use of the -p option cc(l) to invoke profiling imposes a limit of 600 (300 on the PDP-11) 
functions that may have call counters established during program execution. For more counters 
you must call monitor{3C) directly. If this limit is exceeded, other data will be overwritten and 
the mon.out file will be corrupted. The number of call counters used will be reported automati- 
cally by the prof command whenever the number exceeds 5/6 of the maximum. 
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NAME 

prs - print and summarize an SCCS file 

SYNOPSIS 

prs [-d[dataspec]] [-r[SID]] [-e] [-1] [-c] [-a] files 

DESCRIPTION 

Prs printss on the standard output, parts or all of an SCCS file (see sccsfile{4)) in a user-supplied 
format. If a directory is named, prs behaves as though each file in the directory were specified as 
a named file, except that non-SCCS files (last component of the path name does not begin with 
s.), and imreadable files are silently ignored. If a name of - is given, the standard input is read; 
each line of the standard input is taken to be the name of an SCCS file or directory to be pro- 
cessed; non-SCCS files and imreadable files are silently ignored. 

Arguments to prs, which may appear in any order, consist of keyletter arguments, and file names. 

All the described keyletter argiunents apply independently to each named file: 

-d[dataspec] Used to specify the output data specification. The dataspec is a string consisting 
of SCCS file data keywords (see Data Keywords below) mterspersed with 
optional user supplied text. 

-r[SID] Used to specify the 5CCS /Dentification (SID) string of a delta for which infor- 

mation is desired. If no SID is specified, the SID of the most recently created 
delta is assumed. If an SID is specified, it must agree exactly with an SID in the 
file (i.e. the SID structure used by get{l) does not work here). 

-e Requests information for all deltas created earlier thsin and including the delta 

designated via the -r keyletter or the date given by the -c option. 

-1 Requests information for all deltas created later than and including the delta 

designated via the -r keyletter or the date given by the -c option. 

-c [cutoff] CutoflF date-time, in the form 

YY[MM[DD[HH[MM[SS]]]]] 

Units omitted from the date-time default to their maximiun possible values. 
Thus, -c7502 is equivalent to -c 7502 28235959. One or more non-numeric 
characters can be used to sepsirate the various 2-digit segments of the cutoff date 
(for example -c77/2/2 9:22:25). 

-a Requests printing of information for both removed, i.e., delta type = R, (see 

rmdel{l)) and existing, i.e., delta type = D, deltas. If the -a keyletter is not 
specified, information for existing deltas only is provided. 

If no option letters (or only -a) are given, prs prints the file name using the default dataspec and 
the -e option. This produces information on all deltas. 

Data Keywords 

Data keywords specify which parts of an SCCS file are to be retrieved and output. All parts of an 
SCCS file (see sccsfile{'i)) have an associated data keyword. There is no limit on the munber of 
times a data keyword may appear in a dataspec. 

The information printed by prs consists of: (1) the user-supplied text; and (2) appropriate values 
(extracted from the SCCS file) substituted for the recognized data keywords in the order of 
appearance in the dataspec. The format of a data keyword value is either Simple (S), in which 
keyword substitution is direct, or Multi-line (M), in which keyword substitution is followed by a 
carriage return. 

User-supplied text is Einy text other than recognized data keywords. Escapes may be used as fol- 
lows: 
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tab 


\t 


new-line 


\n 


colon 


\: 


backspace 


\b 


carriage-return 


\r 


form feed 


\f 


backslash 


W 


single quote 


V 



The default dataspec is: 



:Dt:\t:DL:\nMR8:\n:MR:C0MMENTS:\n:C: 





TABLE 1. sees Files Data Keywords 






Keyword Data Item 


File Sect. 


Value 


Fmt 


:Dt: 


Delta information 


Delta Tbl 


See below* 


S 


:DL: 


Delta line statistics 




:Li:/:Ld:/:Lu: 


S 


:Li: 


Lines inserted by Delta 




nnnnn 


s 


:Ld: 


Liaes deleted by Delta 




nnnnn 


s 


:Lu: 


Lines imchanged by Delta 




nnnnn 


s 


:DT: 


Delta type 




Dor R 


s 


:I: 


sees ID string (SID) 




:R:.:L:.:B:.:S: 


s 


:R: 


Release number 




nnnn 


s 


:L: 


Level niunber 




nnnn 


s 


:B: 


Branch niunber 




nnnn 


s 


:S: 


Sequence number 




nnnn 


s 


:D: 


Date Delta created 




:Dy:/:Dm:/:Dd: 


s 


:Dy: 


Year Delta created 




im 


s 


:Dm: 


Month Delta created 




nn 


s 


:Dd: 


Day Delta created 




nn 


s 


:T: 


Time Delta created 




:Th:::Tin:::T8: 


s 


:Th: 


Hour Delta created 




nn 


s 


:Tni: 


Minutes Delta created 




nn 


s 


:Ts: 


Seconds Delta created 




nn 


s 


:P: 


Programmer who created Delta 




logname 


s 


:DS: 


Delta sequence number 




nnnn 


s 


:DP: 


Predecessor Delta seq-no. 




nnnn 


s 


:DI: 


Seq # of deltas incl, excl, ign 




:Dn:/:Dx:/:Dg: 


s 


:Dn: 


Deltas included (seq #) 




:DS: :DS:... 


s 


:Dx: 


Deltas excluded (seq #) 




:DS::DS:... 


s 


:Dg: 


Deltas ignored (seq #) 




:DS::DS:... 


s 


:MR: 


MR munbers for delta 




text 


M 


:C: 


eomments for delta 




text 


M 


:UN: 


User names 


User Nm 


text 


M 


:FL: 


Flag list 


Flags 


text 


M 


:Y: 


Module type flag 




text 


S 


:MF: 


MR validation flag 




yes or no 


S 


:MP: 


MR validation pgm name 




text 


s 


:KF: 


Keyword error /warning flag 




yes or no 


s 


:KV: 


Keyword validation string 




text 


s 


:BF: 


Branch flag 




yes or no 


s 


:J: 


Joint edit flag 




yes or no 


s 


:LK: 


Locked releases 




:R:... 


s 
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:Q: 


User defined keyword 




text 


s 


:M: 


Module name 




text 


s 


:FB: 


Floor boundary 




:R: 


S 


:CB: 


Ceiling boundary 




:R: 


S 


:D8: 


Default SID 




:I: 


S 


:ND: 


Null delta flag 




yes or no 


S 


:FD: 


File descriptive text 


Comments 


text 


M 


:BD: 


Body 


Body 


text 


M 


:GB: 


Gotten body 




text 


M 


:W: 


A form of what{l) string 


N/A 


:Z::M:\t:I: 


S 


:A: 


A form of what{l) string 


N/A 


:Z::Y: :M: :I::Z: 


s 


:Z: 


what{l) string delimiter 


N/A 


@(#) 


s 


:F: 


sees file name 


N/A 


text 


s 


:PN: 


sees file path name 


N/A 


text 


s 



* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP: 

If no option letters (or only -a) are given, prs prints the file name, using the default dataspec, and 
the -e option; thus, information on all deltas is produced. 

EXAMPLES 

prs -d Users and/or user IDs for :F: are:\n:UN: s.file 

may produce on the standard output: 

Users and/or user IDs for s.file are: 

xyz 

131 

abc 

prs -d Newest delta for pgm :M:: :I: Created :D: By :P: -r s.file 
may produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case (when no specifications for selecting or printing are given) 

prs s.file 

may produce on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 

MRs: 

bl78-12345 

bl79-54321 

COMMENTS: 

this is the comment line for s.file initisil delta 

for each delta table entry of the "D" type. The only keyletter argument allowed to be used with 
the special case is the -a keyletter. 



FILES 



/tmp/pr????? 



SEE ALSO 

admin(l), delta(l), get(l), help(l), sccsfile(4). 

Source Code Control System User 's Guide in HP- UX Selected Articles. 

DIAGNOSTICS 

Use help{l) for explanations. 
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INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

ps - rejwrt process status 

SYNOPSIS 

ps [-edafl] [-C corefile] [-a swapdev] [-n namelist] [-t tennlist] [-p proclist] [-u uidlist] [-g 
grplist] 

DESCRIPTION 

Ps prints certain information about active processes. Without options, information is printed 
about processes associated with the current terminal. The output consists of a short listing con- 
taining only the process ID, terminal identifier, cimiulative execution time, and the command 
name. Otherwise, the information that is displayed is controlled by the selection of options. 

Options using lists as argvunents can have the list specified in one of two forms: a list of identifiers 
separated from one another by a conuna, or a list of identifiers enclosed in double quotes and 
separated from one another by a comma and/or one or more spaces. 

The options are: 

-e Print information about all processes. 

-d Print information about all processes, except process group leaders. 

-a Print information about all processes, except process group leaders and processes not 

associated with a terminal. 

-f Generate a full listing. (See below for meaning of columns in a full listing.) 

—1 Generate a long listing. See below. 

-c corefile Use the file corefile in place of /dev/mem. 

-8 swapdev Use the file swapdev in place of /dev/swap. This is useful when examining a 
corefile; a swapdev of /dev/nuU will cause the user block to be zeroed out. 

-n namelist The argmnent will be taken as the name of an alternate system namelist file in place 
of /hp-ux. 

-t termlist Restrict listing to data about the processes associated with the terminals given in 
termlist. Terminal identifiers may be specified in one of two forms: the device's file 
name (e.g., tty04) or if the device's file name starts with tty, just the digit 
identifier (e.g., 04). 

-p proclist Restrict listing to data about processes whose process ID nimibers are given in pro- 
clist. 

-u uidlist Restrict listing to data about processes whose user ID numbers or login names are 
given in uidlist. In the listing, the numerical user ID will be printed unless the — f 
option is used, in which case the login name will be printed. 

-g grplist Restrict listing to data about processes whose process group leaders are given in 
grplist. 

The colmnn headings and the meaning of the columns in a ps listing are given below; the letters f 
and 1 indicate the option {full or long) that causes the corresponding heading to appear. All 
means that the heading always appears. Note that these two options determine only what infor- 
mation is provided for a process; they do not determine which processes will be listed. 

F (1) Flags (octal 2ind additive) associated with the process: 

swapped; 

1 in core; 

2 system process; 

4 locked in core (e.g., for physical I/O); 
10 being swapped; 
20 being traced by another process; 
40 another tracing flag; 
S (1) The state of the process: 
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(f,l) 

(all) 

(f,l) 
(f,I) 
(1) 
(1) 
(I) 
(1) 
WCHAN (1) 

STIME (f) 

TTY (all) 

TIME (all) 

CMD (all) 



UID 

PID 

PPID 

C 

PRI 

NI 

ADDR 

SZ 



non-exisieui; 
S sleeping; 
W waiting; 
R running; 

1 intermediate; 
Z terminated; 
T stopped; 
X growing. 

The user ID nmnber of the process owner; the login name is printed under the 

-f option. 

The process ID of the process; it is possible to kill a process if you know this 

datmn. 

The process ID of the parent process. 

Processor utilization for scheduling. 

The priority of the process; higher numbers mean lower priority. 

Nice value; used in priority computation. 

The memory address of the process, if resident; otherwise, the disk address. 

The size in blocks of the core image of the process. 

The event for which the process is waiting or sleeping; if blank, the process is 

running. 

Starting time of the process. 

The controlling terminal for the process (without the initial tty , if any). 

The cumulative execution time for the process (reported in the form min:sec ). 

The command name; the full command name and its arguments are printed 

under the -f option. 

A process that has exited and has a parent, but has not yet been waited for by the parent, is 
marked <defunct> (see zombie process in exit{2)). 

Under the -f option, ps tries to determine the command name and arguments given when the 
process was created by examining memory or the swap area. Failing this, the command name, as 
it would appear without the -f option, is printed in square brackets. 

To make ps output safer to display and easier to read, all control characters in the CMD field are 
mapped to visible equivalents. These are of the form " C where the original character was in the 
range - 037 and c is that value plus 040. 

HARDWARE DEPENDENCIES 

Series 500: 

The F field is always 01. 

In the S field, I means waiting for input from terminal . 

In the S field, the P (paused) state is added. 

In the S field, the T state is not currently supported. 

In the S field, the L means waiting on a file lock via lockf{2) . 

In the S field, the B (blocked) state means blocked via an IPC system call such as 

semop{2), msgrcv{2), or msgsnd{2) . 

The C field is always zero. 

The ADDR field reports the partition niunber. 

In the SZ field, the block size is IK bytes. 

The WCHAN field is always blank. 

The CMD field is renamed COMMAND except when the -fl option is specified. 

The definition of STIME is as follows: 

The time when the process was forked, not the time when it was modified by 
exec; the date is included only if the elapsed time is greater than 24 hours. 
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The s, n, and c options are not currently supported. A diagnostic is printed if they are 
used. 



FILES 



/hp-ux system namelist 

/dev/mem memory 

/dev/sw^ the default swap device 

/etc/passwd supplies UID information 

/etc/ps_data internal data structure 

/dev searched to find terminal ("tty") names 

SEE ALSO 

acctcom(l), kill(l), nice(l), exec(2), exit(2). 

BUGS 

Things can change while ps is running; the picture it gives is only a snapshot in time. Some data 
printed for defunct processes are irrelevant. 

If two special files for terminals are located at the same select code, they are reported in the order 
in which they appear in /dev, not in alphabetical order. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

psqlc, psqlpas, psqlfor - ALLBASE/HP-UX preprocessors for C, Pascal and FORTRAN 

SYNOPSIS 

psqlc -8 ( -i sourcefilename.sql ] [ -p sqloutfilename.f ] 

psqlc DBEnvimomentName [ -o ownemame ] [ -m modulename ) [ -d [ -r ] ] 
[ -i sourcefilename.sql ] ( -p sqloutfilename.f ] 

psqlpas -s [ -i sourcefilename.sql ] [ -p sqloutfilename.f ] 

psqlpas DBEnvimomentName [ -o ownemame ] [ -m modulename ] ( -d [ -r ] ] 
[ -i sourcefilename.sql ] [ -p sqloutfilename.f ] 

psqlfor -8 [ -i sourcefilename.sql ] [ -p sqloutfilename.f ] 

psqlfor DBEnvimomentName [ -o ownemame ] [ -m modulename ] [ -d ( -r ] ] 
[ -i sourcefilename.sql ] [ -p sqloutfilename.f ] 

REMARKS 

The ALLBASE/HP-UX product must be previously installed on the system for paqlc, psqlpas, or 
psqlfor to function. 

DESCRIPTION 

Psqlc, psqlpas and psqlfor invoke the C, Pascal and FORTRAN preprocessors, respectively, for 
programmatically accessing an ALLBASE/HP-UX relational DataBase Environment (DBEnviron- 
ment). Psqlc, psqlpas and psqlfor can be executed by all system users. 

Options 

-8 Specifies that the preprocessor is only to check the syntax of embedded SQL 

commands. 

DBEnvironmentName 

Identifies the DBEnvironment in which a module is to be stored. 

-o ownemame Associates the stored module with a user's login name, a classname, or a group- 
name. You can specify an ovmername for the module only if you have DBA 
authority in the DBEnvironment where the module is to be stored. If not 
specified, the default ownemame is your login name. 

-m modulename 

Assigns a name to the stored module. Modulenames must follow the rules 
goveming HPSQL basic names as described in the ALLBASE/HP-UX SQL 
Reference Manual. If a modulename is not specified, the preprocessor uses the 
PROGRAM Statement name as the modulename. 

-d (DROP) Deletes any module currently stored in the DBEnvironment by the modulename 
and ownemame specified in the options list. If not specified, NODROP is 
assmned and all existing RUN authorities for that module are preserved. 

-r (REVOKE) Is specified when the program being preprocessed already has a stored module 
and you want to revoke all existing RUN authorities for that module. REVOKE 
cannot be specified unless DROP is also specified. If the -r (REVOKE) option 
is not specified, it is assumed that all existing RUN authorities for that module 
are to be PRESERVED. 

-i sourcefilename.sql 

Identifies the name of the input file containing the source code to be prepro- 
cessed. If sourcefilename.sql is not specified, a file by the name of sqlin is 
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assumed. It is recommended that the source file name have a file extension of 
".sql"; however, this is not required. 

— p sqloutfilename.f 

Identifies the name of the output file containing the preprocessor generated code. 
If sqloutfilename.f is not specified, the preprocessor generated code is written to a 
file with the same name as the source file name but with an appended file exten- 
sion of ".f". 

AUTHOR 

Psqlc, psqlpas, and psqlfor were developed by Hewlett-Packard. 

FILES 

/usr/bin/hpdbdaemon cleanup daemon program file 

/usr/bin/psqlc C preprocessor program file 

/usr/bin/psqlpas Pascal preprocessor program file 

/usr/bin/psqlfor FORTRAN preprocessor program file 

/usr/lib/hpsqlproc HP SQL program file 

/usr/bin/isql Interactive SQL program file 

/usr/bin/sqlutil SQLUTIL progrsim file 

/usr/lib/hpsqlcat HP SQL message catalog file 

/usr/lib/isqlwel Interactive SQL welcome banner file 

/usr/lib/libsql.a run time routine library file 

SEE ALSO 

ALLBASE/HP-UX HPSQL C Application Programming Guide. 

ALLBASE/HP-UX HPSQL Pascal Application Programming Guide. 
ALLBASE/HP-UX HPSQL FORTRAN Application Programming Guide. 
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NAME 

ptx - permuted index 

SYNOPSIS 

ptx [ options ] [ input [ output ] ] 

DESCRIPTION 

Ptx generates the file output that can be processed with a text formatter to produce a permuted 
index of file input (standard input and output default). It has three phases: the first does the per- 
mutation, generating one line for each keyword in an input line. The keyword is rotated to the 
front. The permuted file is then sorted. Finally, the sorted lines are rotated so the keyword 
comes at the middle of each line. Ptx output is in the form: 

.XX tail before kejrword keyword and after head 

where .xx is assumed to be an nroff or troff macro provided by the user, or provided by the mptx 
macro package. The before keyword and keyword and after fields incorporate as much of the line 
as will fit around the kej^word when it is printed. Tail and head, at least one of which is always 
the empty string, are wrapped-around pieces small enough to fit in the unused space at the oppo- 
site end of the line. 

The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter by using a line length of 100. 

-w n Use the next argument, n, as the length of the output line. The default line length is 

72 characters for nroff and 100 for troff. 

-g n Use the next argument, n, as the number of characters that ptx will reserve in its cal- 

culations for each gap Jimong the four parts of the line as finally printed. The default 
gap is 3. 

-o only Use as keywords only the words given in the only file. 

-i ignore Do not use as keywords any words given in the ignore file. If the -i and -o options 
are missing, use /usr/lib/eign as the ignore file. 

-b break Use the characters in the break file to separate words. Tab, new-line, and space char- 
acters are always used as break characters. Punctuation characters are treated as 
part of the word in the absence of this option. 

-r Take any leading non-blank characters of each input line to be a reference identifier 

(as to a page or chapter), separate from the text of the line. Attach that identifier as 
a 5th field on each output line. 

FILES 

/usr/lib/eign 
/bin/sort 
/usr/lib/tmac/tmac .ptx 

SEE ALSO 

nroff'(l), nun(5). 

BUGS 

Line length coimts do not account for overstriking or proportional spacing. 

Lines that contain tildes ( ) are botched, because ptx uses that character internally. 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

pwd - working directory name 

SYNOPSIS 
pwd 

DESCRIPTION 

Pwd prints the path name of the working (current) directory. 

SEE ALSO 

cd(l). 

DIAGNOSTICS 

"Cannot open .." and "Read error in .." indicate possible file system trouble and should be 
referred to the system manager. 

INTERNATIONAL SUPPORT 

8-bit filenames, messages. 
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NAME 

query - interactive IMAGE database access 

SYNOPSIS 

query 

Remarks: 

Query is implemented on the Series 500 only, and is not included in the standard HP-UX operating 
system. Optional IMAGE software must be installed on the system before query can be used. 

DESCRIPTION 

Query is an interactive, command driven program to simplify IMAGE database access. It 
can be used to generate reports from the database, add information to the database, change 
information in the database, and aid in developing programs that access databases using IMAGE 
library subroutines. 

Consistent with the HP-UX environment in which it operates, query is initiated by simply tsrping 
its name. There are no options or parameters. Input and output redirection can be done at the 
shell level ( < > ) although more convenient methods are available via query commands. 

A list of the available commands: 



data-base= 


help 


exit 


! 


list 


form 


find 


xeq 


update a 


update d 


update r 


report 



Query accepts these commands in upper- or lower-case. Special care must be taken in the case of 
set names, item names, and item values since these are case sensitive. That is, Setname, set- 
name, and SETNAME are three imique sets. 

All query commands must be followed by a semicolon. Query waits silently for a semicolon or a 
zero-length record before processing a command. A zero-length record is entered as a soli- 
tary carriage return. This method of signaling the end of a command line enables you to enter 
commands which are several lines long. Line length is limited to 256 characters. At any point 
in a line, you may type a carriage return and continue the command line, thus improving the rea- 
dability of long command lines. 

Once initiated, query identifies itself and gives the prompt: 

NEXT? 

Whenever this prompt appears, you may enter any of the query commands, which are described 
below. 

DATA-BASE= 

The data-ba8e= command opens a database. You can type: 

data-base=data_base__name; 

where data— base— name is the name of a database. If you are presently in the directory 
where the database exists, you need only give the database name. If the database is in 
smother directory, you need to supply a partial or complete path name. 

Some examples are: 

data-base=/users/fred/inventory; 
specifies a database called "inventory" in the directory /users/fred. 

data-base=equipment; 

specifies a database called "equipment" in the current directory. 

As part of the data-ba8e= conunand, query asks for a password for that database with the 
prompt: 
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PASSWORD? 

The password is not echoed on the terminal as you type it. As usual, the password must 
be followed by a semicolon. If no password is required, simply press RETURN. 

Provided the database name £ind password Eire valid, the database is opened with "modify 
shared" access (DBOPEN mode 1). The command prompt "NEXT?" appears. 

HELP 

The help command provides a syntax model, a brief description, and examples of itself or 
any other query command. It can be invoked in the following ways: 

help [ command ]; 

or 
? [ command ]; 

where command is £iny query command. If no command is supplied, help describes itself 
and gives a list of the commands for which help is available. 

EXIT The exit command provides you with a graceful way to terminate the query program. It is 
entered thus: 

exit; 
Query can also be terminated by hitting the BREAK key in response to a command prompt. 
I 

At any time, in response to a "NEXT?" prompt, you may wish to execute a shell commcind 
without leaving the query program. This is useful when debugging report procedure files 
from within query, or routing output files to a printer diuring a query session. For example: 

!pr filename I Ipr 

runs the formatter /printer pr on a file called filename, and pipes the output into the Ipr 
program. 

A shell command following an exclamation mark is executed, and query is suspended until 
that command is completed. Query processing can be continued when the "[Hit return to 
continue QUERY]" message appears. 

LIST The list command is a convenient method of redirecting output from within the query pro- 
gram. Query sends output to stdout (the input device) by default. To send output else- 
where, type: 

list=filename; 

Output is sent to filename in the current directory. It may be sent to a file in cinother 
directory by specifying the desired pathname. 

An example is: 

list=/usr/spool/uucppublic/report; 

which specifies that the output file is /usr/spool/uucppublic/report. 

If query finds that the named file already exists, it prints the message: 

FILE ALREADY EXISTS. (O)VERWRITE IT, (A)PPEND TO IT, 
OR (N)EITHER ? 

You type o, a, or n to select an option. If you choose n, query prompts: 

NEW FILE NAME= 

in response to which you provide a (presiunably) different file name. Otherwise, query 
overwrites or appends to the selected file, as instructed. Output directed to a file is proi> 
erly formatted for direct submission to lpr{l). At any time during a query session, you may 
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return output to the terminal by tjrping: 

list; 

This can be repeated as often as necessary, using the same file or many different files for 
output. When the list command appears in an XEQ file, no choices are offered. The 
specified file is silently opened and any output is appended to it. 

FORM 

The form command outputs a schema description for the open database. It lists each data 
set name, its t3T)e (automatic master, manual master, or detail), the set capacity, and the 
current number of entries in the set. With each data set, each item is listed including its 
name, type (alphanmneric, integer, or real), length in bytes, and number of elements in the 
item. Query also identifies key items, sort items (the sort item name may be tnmcated), 
and indicates whether you have write access for the item. It is initiated by typing: 

form; 

Form's output is directed to the file specified by the list command, or stdout by default. 
Its output can be terminated by hitting the BREAK key. Within a few seconds, output 
stops and a command prompt (NEXT?) appears. 

FIND 

A major use of any query program is to search a database for an arbitrary group of entries 
meeting some criteria. Find is used in conjunction with the update or report commands, 
providing "victims" for the update or report. It is entered by typing: 

find retrieve_procedure end; 

where retrieve— procedure is a group of data item names, data item values, and relational 
operators joined together by logical connectors. 

A retrieve procedure defines a relationship between a data item and a data item value, and 
the find command collects entries which satisfy that relationship for later use by update 
or report. A typical retrieve procedure looks like this: 

[setname.Jitenmame operator "value" 

where setname is the name of a data set which contains the data item. It is always 
accepted, but is not necessary when the item name exists in only one data set, or when the 
set name has been previously established in the retrieve procedure. Itemname is simply the 
name of a data item. For compound items, only the first element is used. Operator is one 
of the following relational operators: 



is, ie 


equal to 


isnot, ine 


not equal to 


ilt 


less than 


init 


not less than 


igt 


greater than 


ingt 


not greater than 



Value is enclosed in quotation marks (" ") and is compared to the value of the named item 
for each entry in the specified (or implied) set. It should be appropriate for the data item 
type. 

Two or more retrieve procedures can be joined by the logical operators and and or to make 
a more complex procediue. Parentheses are not allowed in find procedures, so care should 
be taken in ordering statements in a compoimd retrieve procedure. 

Some examples are: 
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find inventory.quantity is "324" end; 

searches all entries in the "inventory" set for a "quantity" equal to "324". This would 
be appropriate for a quantity of any type (alphanumeric, integer, or real). 

find part—description ie "widgit" end; 

searches all entries in the set which contains the item "part_description" for a value of 
"widgit". The value would obviously be inappropriate for an item type of integer or real. 
This example generates an error if "part—description" exists in more than one set in the 
database. 

find inventory.quantity igt "324" and part— description isnot "widgit" end; 

searches all entries in the set "inventory", collecting those that show a quantity greater 
than 324, excluding widgits. The items "quantity" and "part— description" must both be 
items contained in the set "inventory". 

XEQ The xeq command allows any number of commands to be read from a file created by 
any of the HP-UX editors. Commands must appear in the file exactly as they would be 
entered interactively, one command per line. The xeq command is entered: 

xeq=filename; 

The filename may be an absolute pathname, if necessary. Query reads commands from 
that file until it encounters either an end-of-file or another xeq command. When end-of-file 
is reached, query returns to an interactive state. When an xeq command is encountered 
within an xeq file, query closes the ciurent xeq file and begins reading commands from the 
new one. The old one is not re-opened. Xeq files can be nested up to 10 deep. 

A few commands behave diflFerently when they occur in an xeq file. The "li8t=file" com- 
mand silently opens the specified file and appends data to it. The update mode of the 
update r command can be terminated only by a lone semicolon. (In interactive use, 
update r can be terminated by a semicolon or a zero-length record.) 

UPDATE A 

Update a (add) adds entries to a data set. It is the only update which does not 
require a preceding find. The update add command is entered: 

update a, setname; 

or 
update add, setname; 

Query checks the validity of the set name, and then prompts for item values one at a time. 
The item name is displayed followed by an "=". The value to be assigned to that item 
should then be entered, enclosed in quotes, and followed by a semicolon. Query then 
prompts for the next item value. Only one prompt is given for comiwund data items; the 
item values should be entered each in quotes, separated by commas. Null values may be 
entered by a lone carriage return in response to a prompt, but query insists on valid values 
for key items. Addition of detail entries requires that values for key items already exist in 
the corresponding master set(8). 

The BREAK key can be used to abort an update a command. No update takes place, and 
a command prompt appears. 

UPDATE D 

Update d (delete) deletes entries from a data set. It requires a preceding find, and 
complains if not satisfied. The command is entered: 

update d; 

or 
update delete; 
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As a safety check, query asks "OK TO DELETETfYES/NO)". Upon receipt of a y or n, 
query proceeds as directed. It refuses to delete master set entries which contain chain heads 
with non-empty chains (i.e. connected detail sets), and displays a message to that eflfect. 

UPDATE R 

Update r (replace) also must be preceded by a find. It is a means of changing item values 
in an existing entry. It is invoked by typing: 

update r; 

or 
update replace; 

Query responds with the prompt "ITEM =". You then enter: 

item_name= " value " ; 

where item— name is an item name which exists in the entries in the select file. Value is a 
value appropriate to the item type (alpha, integer, or real) enclosed in double quotes. 

When you have finished entering the changes desired, a lone carriage retiu^ or a lone semi- 
colon exits this update mode, and query executes the changes and retiuns to the command 
level. (In an xeq file, only the semicolon suflSces.) The new value(s) are inserted into all 
entries collected in the select file. Updates are refused for key items and sort items in mas- 
ter sets. Updating key or sort items in detail sets causes that record to be deleted and re- 
entered with the new values. A report following such an update may give an "EMPTY 
RECORD" error message. Don't panic. The record may be foimd at its new location by a 
find command. 

The BREAK key can be used to abort an update r command. No upxlate takes place, and 
a command prompt appears. 

REPORT 

The report command provides many featiu'es to display information about the entries in 
the select file. The information is sent to the list device (the input device, by 
default). Report's output can be terminated by using the BREAK key, which yields a 
command prompt (NEXT?). You can request the name and value of each data item for 
all the data entries specified in the select file, or request the data item values for all of 
the data entries without printing the data item name. Also you may create output for- 
mats complete with page headings, page nimabers, colimm headings, space and page 
control, and selectivity in item value display. Report can be invoked in one of three 
ways: 

report all [, character]; 

or 
report name=procedm-e_name; 

or 
report; 
body 
end; 

where character is any ASCII printing character which determines the printing of certain 
optional information. 

Procedure— name is the name of a file (specified as a relative or absolute pathname) which 
contains report commands stored via a system editor, such as ed or vi. 

Body consists of header, detail, edit, and sort commands as outlined below. 

The three forms of the report command are described below. 
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REPORT ALL [.CHARACTER]; 

prints the entire data item and all elements of a compoimd item. This report form 
prints the item name, followed by "=", followed by the item value. The optional 
character causes query to print only the item value, without the item name and "=". 
All item values appear left justified, and numbers are stripped of insignificant zeros. 
Real nimibers may appear in decimal form or scientific notation, as necessary. This is 
the only report form which shows all values for compound data items. 

REPORT NAME=PROCEDURE_NAME; 

gets header, detail, edit, and sort commands from a file, reading commands imtil an 
"end;" or an error is encountered. The contents of a procedure file are identical to 
the "body" in the next form of the report command. It should be noted that the use 
of the shell escape (!) is a valuable aid in the development of procedure files. It 
enables you to invoke an editor, modify a file, exit it, and return to the same point in 
query to test the file, without having to re-define the database or re-establish a select 
file. 

REPORT; 

BODY 

END; accepts report commands from the user, scanning each line as it is entered for syn- 
tax errors. The entry of an "end; " command initiates the execution of the commands, 
producing a report. The body is a collection of the following commands: 

Header Prints title, colimrn headings, and page numbers at the top of each 

report page. 
Detail Prints data item values in the column position specified. 

Edit Describes the number of decimal places to be displayed for real 

numbers. 
Sort Sorts data entries based upon the value of a specified data item. 

Report Formatting 

The above commands can be formatted using the following parameters. (Note: these are parame- 
ters to the report commands, not conunands themselves.) 

print position 

Specifies the ending colmnn for an item value or heading. 

space and space control 

Causes line skips between item values or heading lines. 

skip and skip control 

Causes page skips between item values or heading lines. 

edit 

Specifies edit conamands to which output item values should conform. 

These parameters are described below. 

print iK>8ition 

This parameter is an integer between 1 amd 132 which indicates the colmnn 
nmnber in which the last character of an item value should appear in a header or 
detail line. It is your responsibility to avoid overlap between fields on the same line. 
However, in most cases query replaces an overlapping value with asterisks to indi- 
cate an error. 

space and space control 

This p£irameter outputs blank lines either before or after the printing of a header 
string or detail line value. The keyword space should be followed by either an a or 
b, indicating where the blank line should appear - after or before the line to be 
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printed. The a or b may be followed by an integer in the range 1-5, to skip mul- 
tiple lines. Absence of the integer causes query to skip 1 line. These may appear 
more than once in a command, as in spacing before and after a line: 

hl,"page",35,space b2,space a3; 

This generates two blank lines before printing "page", and three blank lines after- 
ward. 

skip and skip control 

Similar to space, skip yields page feeds either before or after the printing of a line. 
Unlike space, skip csm only be used with a "detail" command. The keyword skip 
is followed by an a or b to direct where the page feed should be placed (see "space 
and space control" above). Normally, query prints 54 lines per page before skipping 
to a new page. 

edit 

The edit parameter is the letter e followed by ajx integer in the range 0-9. This 
nimiber corresponds to a munbered edit command which specifies the nrnnber of 
decimal places (for real numbers) or the number of characters (for alphanumeric 
strings) to be printed. 

Report Commands 

h (lieader conamand) 

The header command is used to print heading information of your choice at the 
top of each page of the report. A maximum of five lines of header information 
can appcEir at the top of each report page. The format of the header command is: 

hnmnber,data^type,print_position [ ,space space-control]; 

where number is an integer from 1 to 5 specifying on which header line (out of five 
possible lines) the information is to appear. Header information in a header com- 
mand labeled "hi" appears in the first line, "h2" appears in the second line, etc. 

Data— type is either £in ASCII character string enclosed in double quotes, or the 
word pageno (without quotes). If pageno appears in the header command, query 
prints the page number of the report in the position specified by print— position. 
Query increments the page nmnber automatically for each page printed. 

Print— position, space, and space-control are parameters defined in the section on 
report formatting. 

An example is: 

hl,"PAGE",70,space b2; 

hl,pageno,76; 

h2, "DAILY REPORT",50,space a3; 

which prints the word "PAGE" with the letter "E" in column 70, on the second 
line from the top of a page (via the "space b2" parameter). On the same line, the 
page number is printed ending in column 76. The next line contains "DAILY 
REPORT" ending in column 50, followed by three blank lines. 

d (detail command) 

The detail command indicates which data items of a data entry specified in the 
select file are to be printed in the report. Data items can be printed on up to 10 
different lines. Query prints only the values of data items which appear in a detail 
command. 

If an ASCII value length exceeds the distance between a preceding value on the 
same line or the left margin, it is silently tnmcated on the left. If a muneric 
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value overlaps in the same manner, it is replaced by a series of asterisks, indicat- 
ing the error. 

Detail commands without an edit parameter print nmneric values in whatever for- 
mat necessary to give maximum accuracy. 

The format of a detail command is: 

d[n] ,data^type,print_po8ition [ , space space-control ] [ , skip 
skip-control ] ( , edit ] ; 

where n is an integer from 1 to 9. Each number specifies a different line on which 
the data items are printed. If the niunber is omitted, the unnumbered detail item is 
printed on a separate line above any numbered detail item lines. The lowest num- 
bered command is printed first and all others follow in nmneric order. Detail com- 
mands with the same number are printed on the same line. 

Data— type is either an ASCII character string enclosed in double quotes, or the 
name of a data item contained in the data entries specified in the select file. NOTE: 
the report command processor expects the data item name by itself. Preceding the 
item name with a set name generates an error. 

Print— position, space, space-control, skip, skip-control, and edit are parameters 
defined in the section on report formatting. 

e (edit command) 

The edit command is used to format the printing of real and/or alphanumeric item 
values. Up to ten edit commands, labeled from eO to e9, can be used m a report. 
To edit output from a detail command, you include the label of the desired edit 
command. Query refers to the labeled edit command to edit the value printed by 
the detail command. The same edit command can be referenced by more than one 
detail command in the same report, and each edit command must be referenced at 
least once in the report body. The format of the edit command is: 

enumber , "places,format " ; 

where number is £in integer from to 9, identifying the edit command. An integer 
cannot be used to identify more than one edit conunand. 

Places is an integer indicating the number of digits to follow the decimal point (for 
real numbers) or the uiunber of characters to be printed (for alphanumeric strings). 

Format is one of the following single letters: 

f indicating that the munber should be formatted in decimal form, 
with the specified number of digits following the decimal point. 
Nimibers accurate to more than the specified number of places are 
rounded. 

e indicating that the number should be formatted in scientific notation 
with the specified nimiber of digits following the decimal point. 

s indicating that the data item is an alphanumeric string. The number 

of characters printed is specified by the accompanying integer. If 
you specify 10 characters for a data item 40 characters in length, the 
leftmost 10 characters are printed. If you specify 100 characters for 
the same data item, only 40 characters are printed. 

Here are some examples: 

el,"6f"; 

dl,rea] number, 40,el; 
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mieht vield such numbers as: 



2.340000 

25487.123456 

1.000000 



and 



el, "46"; 
dl,realnuin,40,el; 

might yield 

2.3400e+0 
3.2549e+5 
l.OOOOe+0 

and 

el, "158"; 
dl,String,40,el; 

might yield 

Smith, Jame 
truncate ri 
Walker, Mau 
Doe, John 

Finally, the difference between the edit command and the edit parameter should be 
emphasized. For example, 

el,"7r; 

dl,Any_real,30,el; 

end; 

The first line is an edit command, specifying a format for real niunbers. In the 
second line, the "el" is a parameter, indicating that the real nimiber(s) "Any_real" 
should be printed according to the format shown in the "el" command. 

s (sort command) 

The sort command specifies an item upon which you want the entries in the select 
file sorted. The format of the sort command is: 

s,itemname; 

where itemname is the name of a data item which appears in entries currently 
stored in the select file. 

A sort item value may not exceed 80 bytes in length. In the case of a compoimd 
data item, sort uses only the first value in that item. After a "find", the entries 
appear in the select file in the order the find command encoimters them. The sort 
command will rearrange those entries in ascending alphabetic or niuneric order, 
depending on the sort item. 

Report Example 

Assimiing that Emp—.name is a 20-byte alphanumeric item, Emp^age is a 2-byte integer, and 
Emp_'wage is a 4-byte real: 

HI, "EMPLOYEE REPORT ",34,space b3; 

hl,"PAGE",52; 

hl,pageno,56,space a2; 

h2,"NAME",7; 

H2,"AGE",27; 
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H2, "HOURLY WAGE",52; 

el,"2r; 

s,Emp__name; 

dl ,Emp_aame,20; 

dl,Emp_age,27; 

dl,"$",44; 

dl,Einp_wage,50,el, space a; 

end; 

This report might yield: 

EMPLOYEE REPORT PAGE 1 

NAME AGE HOURLY WAGE 

Anderson,Richard 32 $ 14.75 

Carr,Elaine 21 $ 11.50 

Wilson,Kathy 42 $ 17.25 



Summary 

Although the commands appear throughout this docimaent in lower-case, query accepts them in 
upper-case also. This is helpful when working with databases ported from Series 500 BASIC, in 
which database names, data set names, and data item names are frequently in upper-case. 

It should be stressed that all commands must end with a semicolon or zero-length entry. If 
query seems to have "gone away", be sure that a semicolon followed tha last command 
entered. If this is not the case, an extra carriage return serves to terminate the command 
and prompt query into action. 

Query sometimes appears to be "eating" report commands and doing nothing about them, 
other than supplying the "NEXT?" prompt. This is usually the result of having used the 
"list" command to re-route output earlier in the session, and having forgotten about it. 
Typing 

list; 

re-routes output to the terminal again. 

Abnormal termination of query leaves files in /usr/tmp. It is your responsibility to 
remove these files or they may accumulate and use up large amounts of memory. The files 
can be identified by the owner id, shown by typing "11 /usr/tmp". Do not attempt to 
remove files belonging to anyone else. 



FILES 



/usr /bin/query 

/usr/bin/querysort query's own sort routine 

/usr/lib/query.help help file 

/mst /tvap/* temporary files 
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NAME 

ratfor - rational Fortran dialect 

SYNOPSIS 

ratfor [ options ] [ files ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides 
control flow constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 



default: ] statement 



} 
loops: 



while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make progrsims easier to read and write: 

free form input: 

multiple statements per line and automatic continuation of lines 

comments: 

# this is a comment. 

compiler directives: 

directives beginning with a dollar sign ($) in column one are passed through to 
the compiler unchanged. 

translation of relational: 

>, >=, etc., become ,GT., .GE., etc. 

return expression to caller from function: 
return (expression) 

define: 

define name replacement 

include: 

include file 
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Options are as follows: 

-h causes quoted strings to be turned into Hollerith constructs such as, for example, 

27H. 

-C copies comments to the output and attempts to format it neatly. 

-6c normally, continuation lines are marked with an & in column 1. The option -6c 
makes the continuation character c and places it in coliunn 6. 

Ratfor is best used with /77(1). 

HARDWARE DEPENDENCIES 

Series 200, 300: 

Options may be passed to ratfor through /77(1) by using the -W option specifier. 

Series 500: 

Fc (on /77(1)) does not recognize ratfor.r files. Therefore, ratfor must be called directly. 

The -h option should not be used. 

The -6x option must be used for successful automatic continuation. 

SEE ALSO 

f77(l). 

B. W. Kemighan and P. J. Plauger, Software Tools, Addison- Wesley, 1976. 
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NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev ( file ] ... 

DESCRIPTION 

Rev copies the named files to the standard output, reversing the order of characters in every line. 
If no file is specified, the standard input is copied. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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REVISION (1) 



Series 500 Only 



NAME 

revision - get HP-UX revision information 

SYNOPSIS 

/usr /bin/revision 

Remarks: 

Revision is implemented on the Series 500 only. 

DESCRIPTION 

This command prints six lines to standard output. Those six lines consist of the six data items 
output by uname{2), which give information on the kernel. 

The following is a sample output from a machine whose loader chip was not programmed with a 
serial number: 



System: 


HP-UX 


Release: 


05.11 


Version: 


B 


Machine: 


9050X 


Identity: 


HP-UX NNNNANNNNN 


Nodename: 


hpfcla 


SEE ALSO 




imame(2). 
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NAME 

rm, nndir - remove files or directories 

SYNOPSIS 

rm [ -fri ] file ... 
rmdir dir ... 

DESCRIPTION 

Rm removes the entries for one or more files fi-om a directory. If £in entry was the last link to the 
file, the file is destroyed. Removal of a file requires write permission in its directory, but neither 
read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are printed 
and a line is read from the standard input. If that line begins with y the file is deleted, otherwise 
the file remains. No questions are asked when the -f option is given or if the standard input is 
not a terminal. 

If a designated file is a directory, an error comment is printed unless the optional argument -r has 
been used. In that case, rm recursively deletes the entire contents of the specified directory, and 
the directory itself. (Note that rm c£in recursively remove a maximum of 17 directory levels.) 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, 
whether to examine each directory. 

Rmdir removes entries for the named directories, which must be empty. 

SEE ALSO 

imlink(2). 

DIAGNOSTICS 

Generally self-explanatory. It is forbidden to remove the file .. merely to avoid the consequences 
of inadvertently doing something like: 

rm -r .* 

INTERNATIONAL SUPPORT 

rm: 8- and 16-bit data, 8-bit filenames 

rmdir: 8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

rmdel - remove a delta from an SCCS file 

SYNOPSIS 

rmdel -rSID files 

DESCRIPTION 

Rmdel removes the delta specified by the SID from each named SCCS file. The delta to be 
removed must be the newest (most recent) delta in its branch in the delta chain of each named 
SCCS file. In addition, the SID specified must not be that of a version being edited for the pur- 
pose of making a delta (i. e., if a p-fUe (see get{l)) exists for the named SCCS file, the SID 
specified must not appear in any entry of the p-file). 

If a directory is named, rmdel behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name does not begin with s.) 
and imreadable files are silently ignored. If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be processed; non-SCCS files 
and imreadable files are silently ignored. 

The exact permissions necessary to remove a delta are documented in the Source Code Control 
System User's Guide. Simply stated, they are either (1) if you make a delta you can remove it; or 
(2) if you own the file and directory you can remove a delta. 

FILES 

x.file (see defto(l)) 

z.file (see delta{l)) 

SEE ALSO 

delta(l), get(l), help(l), prs(l), sccsfile(4). 

Source Code Control System User's Guide in HP-UX Selected Articles. 

DIAGNOSTICS 

Use help{l) for explanations. 



Hewlett-Packard Company - 1 - Version B.l, October 1986 



RMNL(l) HP-UX RMNL(l) 



NAME 

rmnl - remove extra new-line characters from file 

SYNOPSIS 
rmnl 

DESCRIPTION 

Rmnl is useful for removing excess white space from files for display on a CRT terminal. Groups 
of more than one \n character are compressed to one \n character, effectively removing all blank 
lines. This is used by the man command. 

Ssp{l) can be used to remove redundant blank lines, rather than all blank lines. 

SEE ALSO 

man(l), ssp(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

rtprio - execute process with realtime priority 

SYNOPSIS 

rtprio priority command [ arguments ] 
rtprio priority -pid 
rtprio -t command [argmnents] 
rtprio -t -pid 

DESCRIPTION 

Rtprio executes command with a realtime priority, or changes the realtime priority of currently 
executing process pid. Realtime priorities range from zero (highest) to 127 (lowest). Realtime 
processes are not subject to priority degradation and are £ill of greater (scheduling) importance 
than non-realtime processes. See rtprio{2) for more details. 

If -t is specified instead of a resiltime priority then rtprio executes command with a timeshare 
(non-realtime) priority, or changes the currently executing process pid from a possibly realtime 
priority to a timeshare priority. The former is useful to spawn a timeshare priority command 
from a realtime priority shell. 

If -t is not specified, command will not be scheduled, or pid's resiltime priority will not be changed, 
if the user is not a member of a group having PRIV_RTPRIO access and is not the super-user. 
When changing the realtime priority of a currently executing process, the effective user ID of the 
calling process must be superuser, or the real or effective user ID must match the real or saved 
user ID of the process to be modified. 

EXAMPLES 

The following example executes the a.out file at a real-time priority of 100: 

rtprio 100 a.out 

The following example sets the currently nmning process with pid 24217 to a real-time priority of 
40: 

rtprio 40 -24217 

AUTHOR 

Rtprto vfas developed by the Hewlett-Packard Company. 

SEE ALSO 

getprivgrp(2), rtprio(2). 

RETURNS 

Rtprio returns exit status if command is successfully scheduled or if pid's realtime priority is 
successfully changed, 1 if command is not executable or pid does not exist, and 2 if command (pid) 
lacks realtime capability, or the invoker's effective user ID is not superuser, or the real or effective 
user ID does not match the real or saved user ID of the process to be changed. 
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NAME 

sact - print current SCCS file editing activity 

SYNOPSIS 

sact files 

DESCRIPTION 

Sact informs the user of any impending deltas to a named SCCS file. This situation occiirs when 
get{l) with the -e option has been previously executed without a subsequent execution of 
delta{l). If a directory is named on the command line, aact behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files (last component of path name 
does not begin with s.) and imreadable files are silently ignored. If a name of - is given, the 
standard input is read with each line being taken as the name of an SCCS file to be processed. 

The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SID of a delta that currently exists in the SCCS file to which 

changes will be made to make the new delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will mjike the delta (i.e., executed a get 

for editing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

sccsdiff - compare two versions of an SCCS file 

SYNOPSIS 

sccsdiff -rSIDl -rSID2 [-p] [-sn] files 

DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates the differences between the two ver- 
sions. Any number of SCCS files may be specified, but arguments apply to all files. 

-rSID? SIDl and SID2 specify the deltas of an SCCS file that are to be compared. Ver- 

sions are passed to bdiff{l) in the order given. The SID's accepted, and the 
corresponding version retrieved for the comparison are the same as for get{l). 

-p pipe output for each file through pr(l). 

-sn n is the file segment size that bdiff will pass to diff{l). This is useful when diff 

fails due to a high system load. 

FILES 

/tmp/get????? Temporary files 

SEE ALSO 

bdiff(l), diff(l), get(l), help(l), pr(l). 

Source Code Control System User 's Guide in HP- UX: Selected Articles. 

DIAGNOSTICS 

"/t/e: No differences" if the two versions are the same. 

Use help{\) for explanations. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

sdb - symbolic debugger 

SYNOPSIS 

sdb [-w] [-W] [ objfil [ corfil [ directory-list ] ] ] 

DESCRIPTION 

Sdb is a symbolic debugger that can be used with C and F77 programs. It may be used to exam- 
ine their object files and core files and to provide a controlled environment for their execution. 

Objfil is normally an executable program file which has been compiled with the -g (debug) 
option; if it has not been compiled with the — g option, or if it is not an executable file, the sym- 
bolic capabilities of adb will be limited, but the file can still be examined and the program 
debugged. The default for objfil is a.out. Corfil is assumed to be a core image file produced 
after executing objfil; the default for corfil is core. The core file need not be present. A - in 
place of corfil will force adb to ignore any core image file. The colon separated list of directories 
{directory-list) is used to locate the soiu-ce files used to build objfil. 

It is useful to know that at any time there is a current line and current file. If corfil exists then 
they are initially set to the line and file containing the source statement at which the process ter- 
minated. Otherwise, they are set to the first line in main{). The current line and file may be 
changed with the source file examination commands. 

By default, warnings are provided if the source files used in producing objfil cannot be found, or 
are newer than objfil. This checking featiu-e and the accompanying warnings may be disabled by 
the use of the -W flag. 

Names of variables are written just as they are in C or F77. Note that names in C are now of 
arbitrary length, adb will no longer truncate names. Variables local to a procedure may be 
accessed using the form procedure '.variable. If no procedure name is given, the procedure contain- 
ing the ciurent line is used by default. 

It is also possible to refer to structiu-e members as variable. member, pointers to structure 
members as variable— > member and array elements as variable[number]. Pointers may be 
dereferenced by using the form pointer[0]. Combinations of these forms may also be used. F77 
common variables may be referenced by using the name of the conunon block instead of the struc- 
tiu'e name. Blank common variables may be named by the form .variable. A number may be 
used in place of a structiure variable name, in which case the number is viewed as the address of 
the structure, and the template used for the structure is that of the last structure referenced by 
sdb. An unqualified structure variable may also be used with various commands. Generally, adb 
will interpret a structiure as a set of variables. Thus, adb will display the values of all the ele- 
ments of a structure when it is requested to display a structure. An exception to this interpreta- 
tion occurs when displaying variable addresses. An entire structure does have an address, and it 
is this value sdb displays, not the addresses of individual elements. 

Elements of a multidimensional array may be referenced as variable[number][number]..., or as 
variable[number, number,...]. In place of number, the form number;number may be used to indi- 
cate a range of values, * may be used to mdicate all legitimate values for that subscript, or sub- 
scripts may be omitted entirely if they are the last subscripts and the full range of values is 
desired. As with structm-es, sdb displays all the values of an array or of the section of an array if 
trailing subscripts are omitted. It displays only the address of the array itself or of the section 
specified by the user if subscripts are omitted. A multidimensional parameter in an F77 program 
cannot be displayed as an array, but it is actually a pointer, whose value is the location of the 
array. The array itself can be accessed sjrmbolically from the calling function. 

A particular instance of a variable on the stack may be referenced by using the form 
procedure '.variable, number. All the variations mentioned in naming variables may be used. 
Number is the occurrence of the specified procediu-e on the stack, counting the top, or most 
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current, as the first. If no procedure is specified, the procedure currently executing is used by 
default. 

It is also possible to specify a variable by its address. All forms of integer constants which are 
valid in C may be used, so that addresses may be input in decimal, octal or hexadecimal. 

Line nvunbers in the source program are referred to as file-name:number or procedure:number. In 
either case the number is relative to the beginning of the file. If no procedure or file name is 
given, the current file is used by default. If no number is given, the first line of the named pro- 
cedure or file is used. 

While a process is running under sdb, all addresses refer to the executing program; otherwise they 
refer to objfil or corfil. An initial argument of -w permits overwriting locations in objfil. 

Addresses 

The address in a file associated with a written address is determined by a mapping associated 
with that file. Each mapping is represented by two triples {bl, el, fl) and {b2, e2, fS) and the 
file address corresponding to a written address is calculated as follows: 

6Jaddress<el 

file address=address+fl-bl 
otherwise 

6,2address<e2 

file address=address+f2-b2, 

otherwise, the requested address is not legal. In some cases (e.g., for programs with separated I 
and D space) the two segments for a file may overlap. 

The initial setting of both mappings is suitable for normal a.out and core files. If either file is 
not of the kind expected then, for that file, bl is set to 0, el is set to the maximiun file size, and 
fl is set to 0; in this way the whole file can be examined with no address translation. 

In order for sdb to be used on laige files, all appropriate values are kept as signed 32-bit integers. 

Commands 

The commands for examining data in the program are: 

t Print a stack trace of the terminated or halted program. 

T Print the top line of the stack trace. 

variable / elm 

Print the value of variable according to length / and format m. A numeric count c indicates 
that a region of memory, beginning at the address implied by variable, is to be displayed. 
The length specifiers are: 

b one byte 

h two bytes (half word) 

I four bytes (long word) 

Legal values for m are: 



c 


character 


d 


decimfil 


u 


decimal, unsigned 


o 


octal 


X 


hexadecimal 


f 


32-bit single precision floating point 


g 


64-bit double precision floating point 
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8 AssTime variable is a string pointer and print characters starting at the 

address pointed to by the variable. 

a Print characters starting at the variable's address. This format may not be 

used with register variables. 

p pointer to procedure 

i disassemble machine-language instruction with addresses printed niuneri- 

cally and symbolically. 

I disassemble machine-language instruction with addresses just printed 

numerically. 
The length specifiers are only eiTective with the formats c, d, u, o and x. Any of the 
specifiers, c, /, and m, may be omitted. If all are omitted, adb choses a length and a format 
suitable for the variable's type as declared in the program. If m is specifiexl, then this for- 
mat is used for displaying the variable. A length specifier determines the output length of 
the value to be displayed, sometimes resulting in tnmcation. A count specifier c tells sdb to 
display that many imits of memory, beginning at the address of variable. The number of 
bytes in one such unit of memory is determined by the length specifier /, or if no length is 
given, by the size associated with the variable. If a coimt specifier is used for the s or a 
command, then that many characters are printed. Otherwise successive characters are 
printed imtil either a null byte is reached or 128 characters are printed. The last variable 
may be redisplayed with the command ./. 

The sh{l) metacharacters * and ? may be used within procedure and variable names, pro- 
viding a limited form of pattern matching. If no procedure name is given, variables local to 
the current procedure and global variables are matched; if a procedure name is specified 
then only variables local to that procedure are matched. To match only global variables, 
the form '.pattern is used. 

linenumber? Im 

variable:1lm 

Print the value at the address from a.out or I space given by linenumber or variable (pro- 
cedure name), according to the format Im. The default format is 'i'. 

variable^m 

linenumber =lm 

number=lm 

Print the address of variable or linenumber, or the value of number, in the format specified 
by Im. If no format is given, then Ix is used. The last variant of this command provides a 
convenient way to convert between decimal, octal and hexadecimal. 

variablelvalue 

Set variable to the given value. The value may be a number, a character constant or a vari- 
able. The value must be well defined; expressions which produce more than one value, such 
as structures, are not allowed. Character constants are denoted ^character. Numbers are 
viewed as integers unless a decimal point or exponent is used. In this case, they are treated 
as having the type double. Registers are viewed as integers. The variable may be an 
expression which indicates more than one variable, such as an array or structure name. If 
the address of a variable is given, it is regarded as the address of a variable of type int. C 
conventions are used in any type conversions necessary to perform the indicated assignment. 

X Print the machine registers £md the current machine-language instruction. 

X Print the current machine-language instruction. 

The commands for examining source files are: 

e procedure 
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e file-name 

e directory/ 

e directory file-name 

The first two forms set the current file to the file containing procedure or to file-name. The 
current line is set to the first line in the named procedure or file. Source files are asstuned to 
be in directory. The default is the current working directory. The latter two forms change 
the value of directory. If no procediu*, file name, or directory is given, the ciurent pro- 
cedure name and file name are reported. 

/regular expression/ 

Search forward ftom the current line for a line containing a string matching regular expres- 
sion as in cd(l). The trailing / may be deleted. 

1 regular expression"! 

Search backward firom the current line for a line containing a string matching regular 
expression as in ed{l). The trailing ? may be deleted. 

p Print the current line. 

z Print the current line followed by the next 9 lines. Set the current line to the last line 
printed. 

w Window. Print the 10 lines aroimd the current line. 

number 

Set the current line to the given line nmnber. Print the new cmrrent line. 

count-f- 

Advance the current line by count lines. Print the new current line. 

count- 
Retreat the current line by count lines. Print the new cmrent line. 

The commands for controlling the execution of the source program are: 

count T args 

count R 

Run the program with the given arguments. The r command with no arguments reuses the 
previous arguments to the program while the R command runs the program with no argu- 
ments. An argmnent beginning with < or > causes redirection for the standard input or 
output, respectively. If count is given, it specifies the number of breakpoints to be ignored. 

linenumber c count 

linenumber C count 

Continue after a breakpoint or interrupt. If count is given, it specifies the breakpoint at 
which to stop after ignoring count - 1 breakpoints. C continues with the signal which 
caused the program to stop reactivated and c ignores it. If a line number is specified then a 
temporary breakpoint is placed at the line and execution is continued. The breakpoint is 
deleted when the command finishes. 

linenumber g count 

Continue after a breakpoint with execution resmned at the given line. If count is given, it 
specifies the number of breakjMiints to be ignored. 

8 count 

S count 

Single step the program through count lines. If no count is given then the program is run 
for one line. S is equivalent to s except it steps through procedure calls. 
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I Single step by one machine-language instruction. I steps with the signal which caused the 
program to stop reactivated and i ignores it. 

variable£m count 

addressma. count 

Single step (as with s) imtil the specified location is modified with a new value. If count is 
omitted, it is eflFectively infinity. Variable must be accessible from the current procedure. 
Since this command is done by software, it can be very slow. 

level V 

Toggle verbose mode, for use when single stepping with S, s or m. If level is omitted, then 
just the current soiu-ce file and/or subroutine name is printed when either changes. If level 
is 1 or greater, each C source line is printed before it is executed; if level is 2 or greater, each 
assembler statement is also printed. A v turns verbose mode ofiT if it is on for any level. 

k Kill the program being debugged. 

procedure(argl,arg2,...) 

procedm«(argl,arg2,...)/m 

Execute the named procedure with the given arguments. Argiunents can be integer, charac- 
ter or string constants or names of variables accessible from the current procedure. The 
second form causes the value returned by the procedure to be printed according to format 
m. If no format is given, it defaults to d. 

linenumber b commands 

Set a breakpoint at the given line. If a procedure name without a line number is given (e.g., 
"proc:"), a breakpoint is placed at the first line in the procedure even if it was not compiled 
with the -g option. If no linenumber is given, a breakpoint is placed at the cm-rent line. If 
no commands are given, execution stops just before the breakpoint and control is returned 
to sdb. Otherwise the commands are executed when the breakpoint is encountered and exe- 
cution continues. Multiple commands are specified by separating them with semicolons. If 
k is used as a command to execute at a breakpoint, control returns to sdb, instead of con- 
tinuing execution. 

B Print a list of the ciurently active breakpoints. 

linenumber d 

Delete a breakpoint at the given line. If no linenumber is given then the breakpoints are 
deleted interactively. Each breakpoint location is printed and a line is read from the stan- 
dard input. If the line begins with a y or d then the breakpoint is deleted. 

D Delete all breakpoints. 

I Print the last executed line. 

linenumber a 

Announce. If linenumber is of the form procnumber, the command effectively does a 
linenumber b 1. If linenumber is of the form proc:, the command effectively does a proc: b 
T. 

Miscellaneous commands: 

I command 

The command is interpreted by s/i(l). 

new-line 

If the previous command printed a source line then advance the current line by one line and 
print the new current line. If the previous command displayed a memory location, then 
display the next memory location. 
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control-D 

Scroll. Print the next 10 lines of instructions, source or data depending on which was 
printed last. 

< filename 

Read conunands from filename until the end of file is reached, and then continue to accept 
conuneinds from standard input. When sdb is told to display a variable by a command in 
such a file, the variable name is displayed along with the value. This commemd may not be 
nested; < may not appear as a command in a file. 

M Print the address maps. 

M [?/][*] b e f 

Record new values for the address map. The arguments ? and / specify the text and data 
maps, respectively. The first segment, [bl, el, fl), is changed unless * is specified, in which 
case the second segment {bl, el, fl), of the mapping is changed. If fewer than three values 
are given, the remaining map parameters are left xmchanged. 

string 

Print the given string. The C escape sequences of the form \character are recognized, where 
character is a nonmuneric character. 

q Exit the debugger. 

The following commands also exist and are intended only for debugging the debugger: 

V Print the version number. 

Q Print a list of procedures and files being debugged. 

Y Toggle debug output. 



FILES 



a.out 
core 



SEE ALSO 

cc(l), f77(l), sh(l), a.out(4), core(4). 

WARNINGS 

When sdb prints the value of an external variable for which there is no debugging information, a 
warning is printed before the value. The value is assumed to be int (integer). 

Data which are stored in text sections are indistinguishable from functions. 

Line number information in optimized fimctions is imreliable, and some information may be miss- 
ing. 



BUGS 



If a procedure is called when the program is not stopped at a breakpoint (such as when a core 
image is being debugged), all variables are initialized before the procedure is started. This makes 
it impossible to use a procedure which formats data from a core image. 

The default type for printing F77 parameters is incorrect. Their address is printed instead of 
their value. 

Tracebacks containing F77 subprograms with multiple entry points may print too many argu- 
ments in the wrong order, but their values are correct. 

The range of an F77 array subscript is assumed to be i to n, where n is the dimension 
corresponding to that subscript. This is only significsint when the user omits a subscript, or uses 
* to indicate the full range. There is no problem in general with arrays having subscripts whose 
lower boimds are not 1. 
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NAME 

sdfchmod - change mode of an SDF file 

SYNOPSIS 

sdfchmod mode device.file ... 

DESCRIPTION 

Sdfchmod is intended to mimic chmod{l). 

An SDF file name is recognized by the embedded colon (:) delimiter (see sdf{4) for SDF file nam- 
ing conventions). 

The permissions of each named file £ire changed according to mode, which may be absolute or 
symbolic. An absolute mode is an octal niunber constructed from the OR of the following modes: 

4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod{2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others. 

A symbolic mode has the form: 

[ who ] op permission [ op permission ] 

The who part is a combination of the letters u (for user's permissions), g (group) and o (other). 
The letter a stands for ugo, which is the default if who is omitted. 

Op can be + to add permission to the file's mode, - to take away permission, or = to assign per- 
mission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or 
group ID) and t (save text - sticky); u, g or o indicate that permission is to be taken from the 
current mode. Omitting permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by commas may be given. Operations are performed in the 
order specified. The letter s is only useful with u or g; t only works with u. 

EXAMPLES 

The examples that follow assmne that an SDF directory structure exists on the HP-UX device file 
/dev/rdsk/cld0s3. 

The first example denies write permission to others for the SDF directory /bin: 

sdfchmod o-w /dev/rd8k/cld0s3:/bin 
The second example makes the SDF file /users/fred/a.out executable and readable by everyone: 

sdfchmod a=rx /dev/rdsk/cld0s3:/user8/fred/a.out 

The third example adds read permission for the group associated with the SDF file 
/last.boot.rev: 

sdfchmod g-Fr /dev/rdsk/cld0s3:/last.boot.rev 

The fourth example assigns read and execute permission to everybody, and sets the set-user-id bit 
for the SDF file /usr/local/hoo: 

sdfchmod 4555 /dev/rdsk/cld0s3:/usr/local/hoo 

In the fifth example, the two commands perform the same function, namely to give read, write, 
and execute permission to the owner and read and execute permissions to everybody else for the 
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SDF file /users/debbie/script: 

sdfchmod a=rx,u+w /dev/rdsk/cldOsSt/users/debbie/script 
sdfchmod 755 /dev/rdsk/cldOsSz/users/debbie/script 

AUTHOR 

Sdfchmod was developed by the Hewlett-Packard Company. 

SEE ALSO 

sdf(4), chmod(l), chmod(2). 



Hewlett-Packard Company - 2 - Version B.l, October 1986 



SDFCHOWN(l) HP-UX SDFCHOWN(l) 

Series 300, 800 Only 



NAME 

sdfchown, sdfchgrp - change owner or group of an SDF file 

SYNOPSIS 

sdfchown owner device:file ... 

sdfchgrp group device:file ... 

DESCRIPTION 

Sdfchown and sdfchgrp are intended to mimic chown{l) and chgrp{l). 

An SDF file name is recognized by the embedded colon (:) delimiter (see sdf{4) for SDF file nam- 
ing conventions). 

Sdfchown changes the owner of the files to owner. The owner may be either a decimal user ID or 
a login name found in the password file. 

Sdfchgrp changes the group ID of the files to group. The group may be either a decimal group ID 
or a group name foimd in the group file. 

EXAMPLES 

The examples that follow assimie that an SDF directory structiu* exists on the HP-UX device file 
/dev/rdsk/cQdldS. 

The first example sets the owner of the SDF file /users/abc/phone.num to adm: 
sdfchown adm /dev/rdsk/c9dld5:/users/abc/phone.num 

The second example sets the group ID of the SDF file /tmp/b.date to the decimal number 105: 
sdfchgrp 105 /dev/rdsk/c9dld5:/tinp/b.date 

AUTHOR 

Sdfchown was developed by the Hewlett-Packard Company. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

sdf(4), chown(l), chgrp(l), group(5), pas8wd(5). 
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NAME 

sdfcp, sdfln, sdfmv - copy, link, or move files to/from an SDF voliune 

SYNOPSIS 

sdfcp filel [ file2 ...] target 
sdfln filel [ file2 ...] target 
sdfmv filel [ file2 ...] target 

DESCRIPTION 

Sdfcp, sdfln, sdfmv are intended to mimic cp(l). 

An SDF file name is recognized by the embedded colon (:) delimiter (see sdf{A) for SDF file nam- 
ing conventions). 

Sdfcp copies an HP-UX file to an SDF file, or an SDF file to either an SDF or HP-UX file. It also 
copies a list of HP-UX files to an SDF directory, or copies a list of SDF files to either an SDF or 
HP-UX directory. 

Sdfln creates links to target if, and only if, £ill files referenced on the command line are on the 
same SDF voliune. 

Sdfmv behaves the same way as sdfcp, except that it moves files instead of copying them. 

The last name on the argument list is the target file or directory. If two or more files are specified 
in the command line, not coimting target, then target must be a directory. Under no cir- 
cvmastances may emy argument other than target be a directory. 

The file name "-" (dash) is interpreted to mean standard input or st£ind£ird output, depending on 
the position in the Eirgument list. The use of the file name "-" makes no sense for sdfln and 
sdfmv. 

EXAMPLES 

The examples that follow assiune that an SDF directory structure exists on the HP-UX device file 
/dev/rd8k/c2d0s2. 

The first example copies the HP-UX file mydata to the SDF file /users/old/mike/olddata: 

sdfcp mydata /dey/rd8k/c2d0s2:/users/old/mike/olddata 

The second example copies the SDF file /users/gary/.cshrc to the SDF directory /tmp (on the 
same SDF volume): 

sdfcp /dev/rdsk/c2d0s2:/user8/gary/.cshrc /dev/rdsk/c2d0s2:/tmp 

The third example copies the SDF files /a/b and /a/c to the HP-UX directory /users/dave: 
sdfcp /dev/rd8k/c2d082:/a/b /dev/rd8k/c2d082:/a/c /visers/dave 

The fourth example copies stsmdard input to the SDF file /users/craig/memo: 

sdfcp - /dev/rdsk/c2d082:/u8ers/craig/memo 

The fifth example copies the SDF file /etc/rc to the SDF file /etc/rc.old on another SDF 
volume residing in the HP-UX device file /dev/rdsk/c2dlsO: 

sdfcp /dev/rd8k/c2d0s2:/etc/rc /dev/rd8k/c2dls0:/etc/rc.old 

The sixth exsimple shows how you can implement a cat{\) program for concatenating SDF files 
using sdfcp in a shell script: 

if [ $# -It 1 ] 
then 

echo "Usage: sdfcat file ..." 

exit 1 
fi 
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for i in $* 
do 

sdfcp $i - 
done 

The seventh example links the SDF file /tmp/x to /users/gary/xl: 

sdfln /dev/rdsk/c2d082:/tmp/x /dev/rdsk/c2d082:/u8er8/gary/xl 

The eighth example moves the HP-UX file /etc/rc.backup to the SDF file /etc/rc: 

sdfmv /etc/rc.backup /dev/rdsk/c2d082:/etc/rc 

Assuming that the current HP-UX directory contains only regular files, the ninth example shows 
how to move all files in an HP-UX directory to the SDF directory /savestufF: 

sdfmv * /dev/rdsk/c2d082:/save8tuflF 

AUTHOR 

Sdfcp was developed by the Hewlett-Packard Company. 

SEE ALSO 

sdf(4), cp(l). 
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NAME 

sdffind - find files in an SDF system 

SYNOPSIS 

sdfiSnd path-name-list expression 

DESCRIPTION 

Sdffind is intended to mimic find{l). 

An SDF file name is recognized by the embedded colon (:) delimiter (see sdf{4) for SDF file nam- 
ing conventions). 

Sdffind recursively descends the directory hierarchy for each path name in the path-name-liat (i.e., 
one or more path names) seeking files that match a boolean expression written in the primaries 
given below. 

-name pattern True if pattern matches the current file name. 

-perm onum True if the file permission flags exactly match the octal niunber onum (see 
chmod{l)). If onum is prefixed by a minus sign, more flag bits (017777, see 
3tat{2)) become significant and the flags are compared: 

(flagsJ£onum) ==onum 

-type c True if the type of the file is c, where c is b, c, d, p, or f for block special file, 

character special file, directory, fifo (a.k.a named pipe), or plain file. 

-type n True if the current file being examined by sdffind is a network special file. 

-links n True if the file has n links. 

—user uname True if the file belongs to the user uname. If uname is niuneric and does not 
appear as a login name in the /etc/passwd file (on the local system, not the 
SDF file system), it is taken as a user ID. 

-group gname True if the file belongs to the group gname. If gname is nmneric and does not 
appear in the /etc/group file (on the local system, not the SDF file system), it 
is taken as a group ID. 

-size n True if the file is n blocks long. 

-exec cmd True if the executed cmd returns a zero value as exit status. The end of cmd 

must be punctuated by aju escaped semicolon. A command argument {} is 
replaced by the current path name. 

-ok cmd Like -exec except that the generated command line is printed with a question 

mark first, and is executed only if the user responds by typing y. 

-print Always true; causes the current path name to be printed. This option must be 

included on the sdffind command line anytime you want sdffind to print the 
path names it has foimd on the standard output. If -print is not specified, 
sdffind locates the files, but fails to tell you about them! 

When -print is specified as the only expression, sdffind prints the absolute 
path names of all files it finds, beginning at each directory in the path-name-list. 
If -print is included as the last component of an expression, sdffind prints the 
absolute path names of only those files which satisfy the other primaries in the 
expression. 

-inum n True if the file has inode number n. 

EXAMPLES 

The examples that follow assimie that an SDF directory structure exists on the HP-UX device file 
/dev/rdsk/cSdOsO. 
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The first example prints the names of all files on the SDF volume /dev/rdsk/c3d0s0: 

sdffind /dev/rdsk/cSdOsO: -print 

The second example prints the name of all the subdirectories under /usr/lib on the SDF file sys- 
tem: 

sdffind /dev/rdsk/cSdOsOr/uBr/lib -type d -print 

The third example gives a long listing of every ordinary file imder /users on the SDF file system: 

sdffind /dev/rdsk/c3dOsO:/users -type f -exec sdfls -1 {} ';' 

The fourth example finds all the files on the SDF volume by the name of "core" and asks whether 
they should be removed: 

sdffind /dev/rdsk/cSdOsO: -name core -ok sdfrm {} ';' 

AUTHOR 

Sdffind was developed by the Hewlett-Packard Company. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

sdf(4), find(l), 8tat(2), chmod(l). 
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NAME 

sdfls, sdfll - list contents of SDF directories 

SYNOPSIS 

sdfls [ -AadlpFi ] [ names ] 
sdfll [ sdfls options ] [ names ] 

DESCRIPTION 

Sdfls is intended to mimic /a(l). Sdfll is equivalent to sdfls -1. 

An SDF file name is recognized by the embedded colon (:) delimiter (see sdf{i) for SDF file nam- 
ing conventions). 

For each SDF directory named, sdfls lists the contents of that SDF directory; for each SDF file 
named, sdfls repeats its name and the information requested. 

If you are the super-user, sdfl^ defaults to listing all files except . (current directory) and .. 
(parent directory). 

There are several options to sdfls: 

-a List all entries; in the absence of this option, entries whose names begin with a period ( . ) 

are not listed. 

-A The same as -a, except that the current directory "." and parent directory ".." are not 
listed. For the super-user, this flag defaults to ON, and is turned off by -A. Due to the 
internal data representation of the SDF directory format, the -A and -a options perform 
the same function. 

-d If argument is a directory, list only its name; often used with -1 to get the status of a 

directory. 

-1 List in long format giving mode, niunber of links, owner, group, size in bytes, and time of 

last modification for each file. 

-p Do not use /etc/passwd and /etc/group to interpret user and group ownership, but 

rather print out the nmneric form. 

-F If the entry is a directory or SRM special file, print a '/' character after the entry, or if 

the entry is executable, print a '*' character after the entry. 

-i Print the inode number of each entry before the listing the entry names. 

EXAMPLES 

The examples that follow assimie that an SDF directory structure exists on the HP-UX device file 
/dev/rdsk/c7s0sl. 

The first example will list all the files in the root directory of the SDF directory structure: 

sdfls -a /dev/rdsk/cTsOsl: 

The second example gives (in long format) all the information about the SDF directory 
/users/root itself (but not the files in the directory): 

sdfls -Id /dev/rdsk/cTsOsli/users/root 

The third example will print (in long form) all the information about every file in the SDF direc- 
tory /etc, printing numbers instead of names for user and group IDs. 

sdfls -ap /dev/rdsk/c7s0sl:/etc 

The previous example is useful if the SDF directory structure was not created on your system but 
brought in from another series 500 system. 

HARDWARE DEPENDENCIES 

On the Series 500, network special files are supported. With the -F option, sdfls will print a '/' 
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character after the entry for a network special file. 

AUTHOR 

Sdfls was developed by the Hewlett-Packard Company. 

FILES 

/etc/passwd to get user ids. 
/etc/group to get group ids. 

SEE ALSO 

sdf(4), l8(l). 
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NAME 

sdfinkdir - make an SDF directory 

SYNOPSIS 

sdfmkdir device:dimame ... 

DESCRIPTION 

Sdfmkdir is intended to mimic mkdir{\). 

An SDF file name is recognized by the embedded colon (:) delimiter (see sdf{A) for SDF file nam- 
ing conventions). 

Sdfmkdir creates specified directories in mode 777, masked with the current value of umask. 

RETURNS 

Sdfmkdir returns exit code if all directories were successfully made; otherwise, it prints a diag- 
nostic and returns non-zero. 

EXAMPLES 

The following example assiunes that an SDF directory structure exists on the HP-UX device file 
/dev/rdsk/cOdlsS. 

This example will create an empty subdirectory named sysmods under the directory /usr/lib: 

sdfmkdir /dev/rdsk/cOdlsSc/usr/lib/sysmods 

AUTHOR 

Sdfmkdir was developed by the Hewlett-Packard Company. 

SEE ALSO 

sdf(4), mkdir(l). 
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NAME 

sdfrm, sdfrmdir - remove SDF files or directories 

SYNOPSIS 

sdfrm [ -fri ] device:file ... 

sdfrmdir device:dir ... 

DESCRIPTION 

Sdfrm and sdfrmdir are intended to mimic rm(l) and rmdir(l). 

An SDF file name is recognized by the embedded colon (:) delimiter (see 8df{A) for SDF file nam- 
ing conventions). 

Sdfrm removes the entries for one or more files from a directory. If an entry was the last link to 
the file, the file is destroyed. 

If a designated file is a directory, an error comment is printed (miless the optional argiunent -r 
has been used, see below). 

The options are: 

-f Remove a file with no questions asked, even if the file has no write permission. 

-r Cause sdfrm to recursively delete the entire contents of a directory, and then the 

directory itself. Sdfrm can recursively delete up to 17 levels of directories. 

-i Cause sdfrm to ask whether or not to delete each file. If -r is also 8i>ecified, 

sdfrm asks whether to examine each directory encoimtered. 

Sdfrmdir removes entries for the named directories, which must be empty. 

EXAMPLES 

The following examples assimie that an SDF directory structure exists on the HP-UX device file 
/dev/rdsk/c6d0sl. 

The first example recursively combs through the SDF directory /tmp and asks if each SDF file 
should be removed (forced, with no file mode checks): 

sdfrm -irf /dey/rdsk/c6d08l:/tmp 

The second example removes the SDF directory /users/doug: 

sdfrmdir /dev/rdsk/c6d08l:/users/doug 

AUTHOR 

Sdfrm was developed by the Hewlett-Packard Company. 

SEE ALSO 

sdf(4), rm(l), nndir(l). 
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NAME 

sdiff - side-by-side difference program 

SYNOPSIS 

sdiff [ options ... ] filel file2 

DESCRIPTION 

Sdiff uses the output of diff{l) to produce a side-by-side listing of two files indicating those lines 
that are different. Each line of the two files is printed with a blank gutter between them if the 
lines Eire identical, a < in the gutter if the line only exists in filel, a > in the gutter if the line 
only exists in fileS, and a I for lines that are different. 

For example: 

X I y 

a a 

b < 

c < 



The following options exist: 

-w n Use the next argument, n, as the width of the output line. The default line length is 

130 characters. 

-I Only print the left side of any lines that Eire identical. 

-8 Do not print identical lines. 

-o output Use the next argument, output, as the name of a third file that is created as a user- 
controlled merging of filel and file2. Identical lines of filel Eind file2 are copied to 
output. Sets of differences, as produced by diff{l), are printed; where a set of 
differences share a common gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for one of the following user-tyi)ed com- 
mands: 

1 append the left colimin to the output file 

r append the right colimm to the output file 

s turn on silent mode; do not print identical lines 

V turn off silent mode 

e 1 call the editor with the left colmnn 

e r call the editor with the right colmnn 

e b call the editor with the concatenation of left and right 

e call the editor with a zero length file 

q exit from the program 

On exit from the editor, the resulting file is concatenated on the end of the output 
file. 

SEE ALSO 

diff(l), ed(l). 
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NAME 

sed - stream text editor 

SYNOPSIS 

sed [ -f sfile ] [ -e script ] [ -n ] [ files ] 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard output, edited according to a 
script of commands. The -f option causes the script to be taken from file sfile; these options 
accmnulate. If there is just one -e option and no — f options, the flag -e may be omitted. The -n 
option suppresses the default output. A script consists of editing commands, one per line, of the 
following form: 

[ address [ , address ] ] function [ argmnents ] 

In normal operation, sed cyclically copies a line of input into a pattern space (unless there is 
something left after a D command), applies in sequence all commands whose addresses select that 
pattern space, and at the end of the script copies the pattern space to the standard output 
(except under -n) and deletes the pattern space. 

Some of the commands use a hold space to save all or part of the pattern space for subsequent 
retrieval. 

An address is either a decimal nmnber that coimts input lines cumulatively across files, a $ that 
addresses the last line of input, or a context address, i.e., a /regular expression/ in the style of 
ed(l) modified thus: 

In a context address, the construction \?regular expression?, where ? is any character, is 
identical to /regular expression/. Note that in the context address 
\xabc\xdefx, the second x stands for itself, so that the regular expression is 
abcxdef. 

The escape sequence \n matches a new-line embedded in the pattern space. 

A period . matches any character except the terminal new-line of the pattern space. 

A commeind line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the address. 

A conunand line with two addresses selects the inclusive rsinge from the first pattern 
space that matches the first address through the next pattern space that matches 
the second. (If the second address is a number less than or equal to the line 
number first selected, only one line is selected.) Thereafter the process is 
repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation func- 
tion ! (below). 

In the following list of functions the maximum nimiber of permissible addresses for each function 
is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of which end with \ to hide the 
new-line. Backslashes in text are treated like backslashes in the replacement string of an s com- 
mand, and may be used to protect initial blanks and tabs against the stripping that is done on 
every script line. The rfile or wfile argimient must terminate the command line and must be pre- 
ceded by exactly one blank. Each wfile is created before processing begins. There can be at most 
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10 distinct wfile arguments. 

(l)a\ 

text Append. Place text on the output before reading the next input line. 

(2) b label Branch to the : command bearing the label. If label is empty, branch to the end of the 

script. 
(2)c\ 
text Change. Delete the pattern space. With or 1 address or at the end of a 2-addres8 

range, place text on the output. Start the next cycle. 
(2) d Delete the pattern space. Start the next cycle. 

(2) D Delete the initial segment of the pattern space through the first new-line. Start the 

next cycle. 
(2) g Replace the contents of the pattern space by the contents of the hold si>ace. 

(2) G Append the contents of the hold space to the pattern spjice. 

(2) h Replace the contents of the hold space by the contents of the pattern space. 

(2) H Append the contents of the pattern space to the hold space. 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an unambiguous form. Non-printing 

characters are spelled in two-digit ASCII and long lines are folded. 

(2)n Copy the pattern space to the standard output. Replace the pattern space with the 

next line of input. 

(2) N Append the next line of input to the pattern space with an embedded new-line. (The 

ciurent line nmnber changes.) 

(2) p Print. Copy the pattern space to the standard output. 

(2) P Copy the initial segment of the pattern space through the first new-line to the stan- 

dard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(2)r rfile Read the contents of rfile. Place them on the output before reading the next input 
line. 

(2) a/regular expression /replacement /flags 

Substitute the replacement string for instances of the regular expression in the pattern 

space. Any character may be used instead of /. For a fuller description see ed(l). 

Flags is zero or more of: 

n n= 1 - 512. Substitute for just the n th occurrence of the regular expression. 

g Global. Substitute for all nonoverlapping instances of the regular eocpression 

rather than just the first one. 

p Print the pattern space if a replacement was made. 

w wfile Write. Append the pattern space to wfile if a replacement was made. 
(2) t label 

Test. Branch to the : command bearing the label if any substitutions have been made since the 
most recent reading of an input line or execution of a t. If label is empty, branch to the end of 
the script. 
(2) w wfile 

Write. Append the pattern space to wfile. 
(2)x 

Exchange the contents of the pattern and hold spaces. 
(2) y/stringl/ strings/ 

Transform. Replace all occurrences of characters in stringl with the corresponding character in 
string8. The lengths of stringl and stringS must be equal. 
(2)! function 
Don't. Apply the function (or group, if function is { ) only to lines not selected by the 



address(es). 
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(0) : label 

This command does nothing; it bears a label for b and t commands to branch to. 

(1) = 

Place the current line nimiber on the standard output as a line. 

(2){ 

Execute the following commands through a matching } only when the pattern space is selected. 

The syntax is: 

{ cmdl 

cmd2 

cmd3 



} 

(0) 

An empty command is ignored. 

(0)# 

If a # appears as the first character on the first line of a script file, then that entire line is treated 

as a comment, with one exception. If the character after the # is an 'n', then the default output 

will be suppressed. The rest of the line after #n is also ignored. A script file must contain at 

least one non-comment line. 

SEE ALSO 

awk(l), ed(l), grep(l). 

BUGS 

There is a limit of 100 commands in the script. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 




send - 


- submit RJE jobs 


SYNOPSIS 




send 


argument ... 



DESCRIPTION 
Send 

Send is a command-level interface to the RJE subsystems. It allows the user to collect input from 
various sources in order to create a nm stream consisting of card images, and submit this run 
stream for transmission to an IBM host computer. Output from the IBM system may be returned 
to the user in either ASCII text form or EBCDIC punch format (see pnch{4)). How output is to be 
disposed of once it returns from the host is determined by a "usr=" specification which should be 
embedded in each job that a user submits for transmission. A detailed description of RJE opera- 
tion and the "usr=" specification is given in HP-UX Remote Job Entry User Guide. 

Possible sources of input to send are: ordinary files, standard input, the terminal, and the output 
of a command or shell file. Each source of input is treated as a virtual file, and no distinction is 
made based upon its origin. Typical input is an ASCII text file of the sort that is created by the 
editor ed(l). An optional format specification appearing in the first line of a file (see fspec{4)) 
determines the settings according to which tabs are expanded into spaces. In addition, lines that 
begin with ~ are normally interpreted as commands controlling the execution of send. They may 
be used to set or reset flags, to define keyword substitutions, and to open new sources of input in 
the midst of the current source. Other text lines are translated one-for-one into card images of 
the run stream. 

The run stream that results from this collection is treated as one job by the RJE subsystems. 
Send prints the card count of the run stream, and the queuer that is invoked prints the name of 
the temporary file that holds the job while it is awaiting transmission. The initial card of a job 
submitted to a host must have a // in the first column. Any cards preceding this card will be 
excised. If a host computer is not specified before the first card of the runstream is ready to be 
sent, send will select a reasonable default. All cards beginning with /*$ will be excised from the 
nmstream, because they are HASP command cards. 

The arguments that send accepts are described below. An argument is interpreted according to 
the first pattern that it matches. Preceding a character with \ causes it to loose any special 
meaning it might otherwise have when matching against an argument pattern. 

Close the current source. 

- Open standard input as a new soiu-ce. 

-|- Open the terminal as a new source. 

:spec: Establish a default format specification for included sources, 

e.g., :m6t-12: 

•.message Print message on the terminal. 

-•.prompt Open standard input and, if it is a terminal, print prompt. 

-\-:prompt Open the terminal and print prompt. 

—flags Set the specified flags, which are described below. 

-\-flags Reset the specified flags. 

= flags Restore the specified flags to their state at the previous level. 

I command Execute the specified HP-UX system command via the one-line shell, 

with input redirected to /dev/null as a default. Open the standard 
output of the command as a new source. 
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i'ine Collect contiguous arguments of this form and write them as consecu- 

tive lines to a temporary file; then have the file executed by the shell. 
Open the standard output of the shell as a new soiu-ce. 

The current directory for the send process is changed to directory. The 
original directory will be restored at the end of the current soiu-ce. 

'comment Ignore this argument. 

1 '.keyword Prompt for a definition of keyword from the terminal imless keyword 

has an existing definition. 

?keyword='xx Define the keyword as a two-digit hexadecimal character code imless it 

already has a non-null replacement. 

?keyword= string Define the keyword in terms of a replacement string unless it already 

has a non-null replacement. 

=:keyword Prompt for a definition of keyword from the terminal. 

keyword=' XX Define keyword as a two-digit hexadecimal character code. 

keyword= string Define keyword in terms of a replacement string. 

host The host machine that the job should be submitted to. It can be any 

name that corresponds to one in the first colimm of the RJE 
configuration file (/usr/rje/lines). 

file-name Open the specified file as a new source of input. 

When commands are executed via $ or ! the shell environment (see environ{5)) will contain the 
values of all send keywords that begin with $ and have the syntax of a shell variable. 

The flags recognized by send are described in terms of the special processing that occurs when 
they are set: 



-I 

-q 
-f 
-t 



List card images on standard output. EBCDIC characters are translated back 
to ASCII. 

Do not output card images. 

Do not fold lower case to upper. 

Trace progress on diagnostic output, by annoimcing the opening of input 



-k 



-1 

-s 

-y 
-g 

-h 
-P 



Ignore the keywords that are active at the previous level and erase any key- 
word definitions that have been made at the ciurent level. 

Process included sources in raw mode; pack arbitrary 8-bit bytes one per 
column (80 colmims per card) until an EOF. 

Do not interpret control lines in included sources; treat them as text. 

Make keyword substitutions before detecting and interpreting control lines. 

Suppress error diagnostics and submit job anyway. 

Gather mode, qualifying -I flag; list text lines before converting them to card 
images. 

Write listing with standard tabs. 

Prompt with * when taking input from the terminal. 

When input returns to the terminal from a lower level, repeat the prompt, if 
any. 
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-a Make -k flag propagate to included sources, thereby protecting them &om 

keyword substitutions. 

-c List control lines on diagnostic output. 

-d Ektend the cvurent set of keyword definitions by adding those active at the 

end of included sources. 

-X This flag guarantees that the job will be transmitted in the order of submission 

(relative to other jobs sent with this flag). 

Control lines are input lines that begin with ~. In the default mode +ir, they are interpreted 
as commands to send. Normally they are detected immediately and read hterally. The -a flag 
forces keyword substitutions to be made before control lines are intercepted and interpreted. 
This can lead to unexpected results if a control line uses a keyword which is defined within an 
immediately preceding ~$ sequence. Arguments appearing in control lines are handled exactly 
like the command arguments to send, except that they are processed at a nested level of input. 

The two possible formats for a control line are: ""argument" and "~##argument#...". In the 
first case, where the ~ is not followed by a space, the remainder of the line is taken as a single 
argmnent to send. In the second case, the line is parsed to obtain a sequence of arguments del- 
imited by spaces. In this case the quotes ' and " may be employed to pass embedded spaces. 

The interpretation of the argument . is chosen so that an input line consisting of ~. is treated 
as a logical EOF. The following example illustrates some of the above conventions: 

8end## - 
~##argument ... 

This sequence of three lines is equivalent to the command synopsis at the beginning of this 
description. In fact, the - is not even required. By convention, the send command reads stan- 
dard input if no other input source is specified. Send may therefore be employed as a filter 
with side-eff^ects. 

The execution of the send command is controlled at each instant by a current environment, 
which includes the format specification for the input source, a default format specification for 
included sources, the settings of the mode flags, and the active set of keyword definitions. This 
environment can be altered dynamically. When a control line opens a new som-ce of input, the 
current environment is pushed onto a stack, to be restored when input resvunes from the old 
source. The initial format specification for the new source is taken from the first line of the file. 
If none is provided, the established default is used or, in its absence, standard tabs. The initial 
mode settings and active keywords are copied from the old environment. Changes made while 
processing the new source will not affect the environment of the old soinrce, with one exception: 
if -d mode is set in the old environment, the old keyword context will be augmented by those 
definitions that are active at the end of the new source. 

When send first begins execution, all mode flags are reset, and the values of the shell environ- 
ment variables become the initial values for keywords of the same name with a $ prefixed. 

The initial reset state for all mode flags is the + state. In general, special processing associated 
with a mode N is invoked by flag -N and is revoked by flag -|-^. Most mode settings have an 
immediate effect on the processing of the current source. Exceptions to this are the -r and -i 
flags, which apply only to included source, causing it to be processed in an iminterpreted 
manner. 

A keyword is an arbitrary 8-bit ASCII string for which a replacement has been defined. The 
replacement may be another string or the hexadecimal code for a single 8-bit byte. At any 
instant, a given set of keyword definitions is active. Input text lines are scanned, in one pass 
from left to right, and longest matches are attempted between substrings of the line and the 
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active set of keywords. Characters that do not match are output, subject to folding and the 
standard translation. Keywords are replaced by the specified hexadecimal code or replacement 
string, which is then output character by character. The expansion of tabs and length check- 
ing, according to the format specification of an input som-ce, are delayed imtil substitutions 
have been made in a line. 

All of the keywords definitions made in the current soiffce may be deleted by setting the -k 
flag. It then becomes possible to reuse them. Setting the -k flag also causes kejrword 
definitions active at the previous source level to be ignored. Setting the +k flag causes key- 
words at the previous level to be ignored but does not delete the definitions made at the current 
level. The =k argument reactivates the definitions of the previous level. 

When kejrwords are redefined, the previous definition at the same level of source input is lost, 
however the definition at the previous level is only hidden, to be reactivated upon return to 
that level tmless a -d flag causes the ciurent definition to be retained. 

Conditional prompts for keywords, ?:A,/p which have already been defined at some higher level 
to be null or have a replacement will simply cause the definitions to be copied down to the 
current level; new definitions will not be solicited. 

Keyword substitution is an elementary macro facility that is easily explained and that appears 
useful enough to warrant its inclusion in the send command. More complex replacements are 
the function of a general macro processor such as m^(l). To reduce the overhead of string com- 
parison, it is recommended that keywords be chosen so that their initial characters are unusual. 
For example, let them all be upper case. 

Send performs two types of error checking on input text lines. Primarily, only ASCII graphics 
and tabs are permitted in input text. Secondly, the length of a text line, after substitutions 
have been made, may not exceed 80 bytes. The length of each line may be additionally con- 
strained by a size parameter in the format specification for an input source. Diagnostic output 
provides the location of each erroneous line, by line number and input source, a description of 
the error, and the card image that results. Other routine errors that are announced are the ina- 
bility to open or write files, and abnormal exits from the shell. NormaUy, the occvurence of any 
error causes send, before invoking the queuer, to prompt for positive affirmation that the 
suspect nm stream should be submitted. 

Before submitting a job to a host, send translates 8-bit ASCII characters into their EBCDIC 
equivalents. The conversion for 8-bit ASCII characters in the octal range 040-176 is based on 
the character set described in Appendix H of IBM System/SlO Principles of Operation (IBM 
SRL GA22-7000). Each 8-bit ASCII character in the range 040-377 possesses an EBCDIC 
equivalent into which it is mapped, with five exceptions: ' into EBCDIC not, 0345 into ~, 0325 
mto EBCDIC cent, 0313 into EBCDIC split-bar; 0177 (DEL) is illegal. In listings requested from 
send and in printed output returned by the subsystem, the reverse translation is made with the 
qualification that EBCDIC characters that do not have valid 8-bit ASCII equivalents are 
translated into '. 

Additional control over the translation process is afforded by the -f flag and hexadecimal char- 
acter codes. As a default, send folds lower-case letters into upper case. Setting the — f flag inhi- 
bits any folding. Non-standard character codes are obtained as a special case of keyword sub- 
stitution. The users should check with the remote IBM system to be sure the special processing 
will be accepted. 

SEE ALSO 

m4(l), sh(l), lseek(2), ascii(5), fspec(4), pnch(4), environ(5). 

BUGS 

Standard input is read in blocks, and unused bytes are returned via /aeeA;(2). If standard input is 
a pipe, multiple arguments of the form - and -'.prompt should not be used, nor should the logical 
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NAME 

sh, rsh - shell, the standard/restricted command programming language 

SYNOPSIS 

sh [ -acefhiknrstuvx ] [ args ] 
rsh [ -acefhiknrstuvx ] [ args ] 

DESCRIPTION 

Sh is a command programming language that executes commands read from a terminal or a file. 
Rsh is a restricted version of the standard command interpreter sh; it is used to set up login 
names and execution environments whose capabilities are more controlled than those of the stan- 
dard shell. See Invocation below for the meaning of arguments to the shell. 

Definitions 

A blank is a tab or a space. A name is a sequence of letters, digits, or underscores beginning with 
a letter or underscore. A parameter is a name, a digit, or any of the characters *, #, ?, -, $, and 
; 

Commands 

A simple-command is a sequence of non-blank words separated by blanks. The first word 
specifies the name of the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command name is passed as argu- 
ment (see exec (2)). The value of a simple-command is its exit status if it terminates normally, 
or (octal) 200+status if it terminates abnormally (see signal{2) for a list of status values). 

A pipeline is a sequence of one or more commands separated by | (or, for historical compatibility, 
by *). The standard output of each command but the last is connected by a pipe {2) to the stan- 
dard input of the next command. Each command is rim as a separate process; the shell waits for 
the last command to terminate. The exit status of a pipeline is the exit status of the last com- 
mand. 

A list is a sequence of one or more pipelines separated by ;, &, icic, or ( |, and optionally ter- 
minated by ; or &. Of these fom- symbols, ; and k have equal precedence, which is lower than 
that of && and 1 1. The symbols && and 1 1 also have equal precedence. A semicolon (;) causes 
sequential execution of the preceding pipeline; an £impersand (&) causes asynchronous execution 
of the preceding pipeline (i.e., the shell does not wait for that pipeline to finish). The symbol && 
(II) causes the list following it to be executed only if the preceding pipeline retiu-ns a zero (non- 
zero) exit status. An arbitrary number of new-lines may appear in a list, instead of semicolons, to 
delimit commands. 

A command is either a simple-command or one of the following. Unless otherwise stated, the 
value returned by a commsmd is that of the last simple-command executed in the commsmd. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next word taken from 
the in word list. If in word ... is omitted, then the for conunand executes the 
do list once for each positiontil parameter that is set (see Parameter Substitu- 
tion below). Execution ends when there are no more words in the list. 

case word in [ pattern [ \ pattern ] . . . ) list ;; ] . . . esac 

A case command executes the list associated with the first pattern that matches 
word. The form of the patterns is the same as that used for filename generation 
(see File Name Generation) except that a slash, a leading dot, or a dot 
immediately following a slash need not be matched explicitly. 

if list then list [ elif list then list ] . . . [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, the list fol- 
lowing the first then is executed. Otherwise, the list following elif is executed 
and, if its value is zero, the list following the next then is executed. Failing 
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that, the else list is executed. If no else list or then list is executed, then the if 
command returns a zero exit status. 

while list do list done 

A while command repeatedly executes the while list and, if the exit status of 
the last command in the list is zero, executes the do list; otherwise the loop ter- 
minates. If no commands in the do list are executed, then the while command 
returns a zero exit status; until may be used in place of while to negate the 
loop termination test. 

(list) Execute list in a sub-shell. 

{ list',} list is simply executed. 

name () { list;} Define a function which is referenced by name. The body of the function is the 
list of commands between { and }. Execution of functions is described below 
(see Execution). 

The following words are only recognized as the first word of a command and when not quoted: 

if then else elif fi case esac for while until do done { } 

Comments 

A word beginning with # causes that word and all the following characters up to a new-line to be 
ignored. 

Conmiand Substitution 

The standard output from a command enclosed in a pair of grave accents ( ^ ^ ) may be used as 
part or all of a word; trailing new-lines are removed. 

Parameter Substitution 

The character $ is used to introduce substitutable parameters . There are two types of parame- 
ters, positional and kejrword. If parameter is a digit, it is a positional parameter. Positional 
parameters may be assigned values by set. Keyword parameters (also known as variables) may 
be assigned values by writing: 

name=value [ name=value ] . . . 

Pattern-matching is not performed on value. There cannot be a function and a variable with the 
same name. 

${parameter} The value, if any, of the parameter is substituted. The braces are required only 
when parameter is followed by a letter, digit, or underscore that is not to be 
interpreted as part of its name. If parameter is * or all the positional parame- 
ters, starting with $1, are substituted (separated by spaces). Parameter $0 is 
set from argument zero when the shell is invoked. 

${parameter:-word} 

If parameter is set and is non-null, substitute its value; otherwise substitute 
word. 

${parameter:^word} 

If parameter is not set or is null set it to word; the value of the parameter is 
then substituted. Positional parameters may not be assigned to in this way. 

${parameter:?word} 

If parameter is set and is non-null, substitute its value; otherwise, print word 
and exit from the shell. If word is omitted, then the message "parameter null or 
not set" is printed. 

${parameter:+word} 

If parameter is set and is non-null then substitute word; otherwise substitute 
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nothing. 

In the above, word is not evaluated unless it is to be used as the substituted string, so that, in the 
following example, pwd is executed only if d is not set or is null: 

echo ${d:- ^ pwd ^ } 

If the colon (:) is omitted from the above expressions, then the shell only checks whether parame- 
ter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

- Flags supplied to the shell on invocation or by the set command. 

? The decimal value returned by the last synchronously executed com- 

mand. 

$ The process number of this shell. 

! The process number of the last background command invoked. 

The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see Execution below). The user may 

not change PATH if executing under rsh. 
The search path for the cd command. 

If this parameter is set to the name of a mail file and the MAILPATH 
parameter is not set, the shell informs the user of the arrival of mail in 
the specified file. 

This parameter sj)ecifies how often (in seconds) the shell will check for 
the arrival of mail in the files specified by the MAILPATH or MAIL 
parameters. The default value is 600 seconds (10 minutes). If set to 0, 
the shell will check before each prompt. 

A colon (:) separated list of file names. If this parameter is set, the 
shell informs the user of the arrival of mail in any of the specified files. 
Each file name can be followed by % and a message that will be printed 
when the modification time changes. The default message is you have 
mail. 

Primary prompt string, by default "$ ". 
Secondary prompt string, by default "> ". 
Internal field separators, normally space, tab, and new-line. 
If this parameter is set to the name of a file writable by the user, the 
shell will write an accounting record in the file for each shell procedure 
executed. Accounting routines such as acctcom{l) and acctcms{lM) can 
be used to analyze the data collected. 

When the shell is invoked, it scans the environment (see Environment 
below) for this name. If it is foimd and there is an 'r' in the file name 
part of its value, the shell becomes a restricted shell. SHELL is also 
used by some processors to determine which command interpreter to 
nm. 

The shell gives default values to PATH, PSl, PS2, MAILCHECK and IFS. HOME and MAIL 

are set by login{l). 

Blank Interpretation 

After parameter and command substitution, the results of substitution are scanned for internal 
field separator characters (those found in IFS) and split into distinct arguments where such char- 
acters are foimd. Explicit null arguments ( " " or ' ' ) are retained. Implicit null argmnents 



CDPATH 
MAIL 



MAILCHECK 



MAILPATH 



PSl 
PS2 
IFS 
SHACCT 



SHELL 



Hewlett-Packard Company 



Version B.l, October 1986 



SH(1) HP-UX SH(1) 



(those resiilting from parameters that have no values) are removed. 

File Name Generation 

Following substitution, each command word is scanned for the characters *, ?, and [ . If one of 
these characters appears then the word is regarded as a pattern. The word is replaced with 
alphabetically sorted file names that match the pattern. If no file name is found that matches the 
patterp, then the word is left imchanged. The character . at the start of a file name or immedi- 
ately following a /, as well as the character / itself, miist be matched explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[ . . . ] Matches any one of the enclosed cheiracters. A pair of characters separated by - 
matches any character lexically between the pair, inclusive. If the first character 
following the opening ' ' [ " is a "!" any character not enclosed is matched. 

Quoting 

The following characters have a special meaning to the shell and cause termination of a word 
imless quoted: 

;&()!"<> new-line space tab 

A character may be quoted (i.e., made to stemd for itself) by preceding it with a \. The pair 
\new-line is ignored. All chfiracters enclosed between a pair of single quote marks ( ' ' ), except 
a single quote, are quoted. Inside double quote marks (" "), parameter and command substitution 
occurs and \ quotes the characters \, ^ , ", and $. "$*" is equivalent to "$1 $2 ...", whereas 
"$@" is equivalent to "$1" "$2" .... 

Prompting 

When used interactively, the shell prompts with the VEilue of PSl before reading a command. If 
at any time a new-line is typed and further input is needed to complete a command, then the 
secondfiry prompt (i.e., the value of PS2) is issued. 

Input/Output 

Before a command is executed, its input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple-command or may pre- 
cede or follow a command and are not passed on to the invoked command; substitution occurs 
before word or digit is used: 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standfird output (file descriptor 1). If the file does not exist then 

it is created; otherwise, it is truncated to zero length. 

»word Use file word as standard output. If the file exists then output is appended to it 

(by first seeking to the end-of-file); otherwise, the file is created. 

«[-]word The shell input is read up to a line that is the same as word, or to an end-of-file. 
The resulting document becomes the standard input. If any character of word is 
quoted, then no interpretation is placed upon the characters of the dociunent; oth- 
erwise, parameter and command substitution occurs, (imescaped) \new-line is 
ignored, and \ must be used to quote the characters \, $, ^ , and the first charac- 
ter of word. If - is appended to «, then all leading tabs are stripped firom word 
and from the document. 

<&digit Use the file associated with file descriptor digit as standard input. Similarly for 

the stEindaxd output using >&digit. (See dup(2)). 

<&- The standard input is closed. Simileirly for the standard output using >&-. 

If any of the above is preceded by a digit, then the file descriptor which will be associated with 
the file is that specified by the digit (instead of the default or 1). For example: 

... 2>&1 
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associates file descriptor 2 with the file currently associated with file descriptor 1. Note that this 
type of I/O redirection is necessary if you want to synchronously collect stdout and stderr output 
in the same file. Redirecting stdout and stderr separately will cause asjrnchronous collection of 
data at the destination (i.e. things written to stdout can subsequently be over-written by things 
written to stderr, and vice- versa). 

The order in which redirections are specified is significant. The shell evaluates redirections left- 
to-right. For example: 

. . . l>xxx 2>&1 

first associates file descriptor 1 with file xxx . It associates file descriptor 2 with the file associated 
with file descriptor 1 (i.e. xxx). If the order of redirections were reversed, file descriptor 2 would 
be associated with the terminal (assuming file descriptor 1 had been) and file descriptor 1 would 
be associated with file xxx . 

If a command is followed by Sc then the default standard input for the command is the empty file 
/dev/nuU. Otherwise, the environment for the execution of a command contains the file descrip- 
tors of the invoking shell as modified by input/output specifications. 

Redirection of output is not allowed in the restricted shell. 

Environment 

The environment (see environ{5)) is a list of name- value pairs that is passed to an executed pro- 
gram in the same way as a normal argmnent list. The shell interacts with the environment in 
several ways. On invocation, the shell scans the environment and creates a parameter for each 
name foimd, giving it the corresponding value. Executed commands inherit the same environ- 
ment. If the user modifies the value of any of these parameters or creates new parameters, none 
of these aflFects the environment unless the export command is used to bind the shell's parameter 
to the environment (see also set -a). A parameter may be removed from the environment with 
the unset command. The environment seen by any executed command is thus composed of any 
immodified name-v£ilue pairs originally inherited by the shell, minus any pairs removed by unset, 
plus any modifications or additions, all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one or more 
assignments to parameters. Thus: 

TERM=450 cmd and 

(export TERM; TERM=450; cmd) 

are equivalent (as far as the execution of cmd is concerned). 

If the -k flag is set, all keyword argmnents are placed in the environment, even if they occur after 
the command name. The following first prints a=b c and then c: 

echo a=b c 
set -k 
echo a=b c 

Signals 

The INTERRUPT and QUIT signals for an invoked command are ignored if the command is fol- 
lowed by &; otherwise signals have the values inherited by the shell from its parent, with the 
exception of signal 11 (but see also the trap command below). 

Execution 

Each time a command is executed, the above substitutions are carried out. If the command name 
matches one of the Special Commands listed below, it is executed in the shell process. If the 
command name does not match a Special Command, but matches the name of a defined function, 
the ftmction is executed in the shell process (note how this differs from the execution of shell pro- 
cedures). The positional parameters $1, $2, are set to the arguments of the function. If the 

command name matches neither a Special Command nor the name of a defined function, a new 
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process is created and an attempt is made to execute the command via exec {2). 

The shell parameter PATH defines the search path for the directory containing the command. 
Alternative directory names are separated by a colon (:). The default path is :/bin:/ii8r/bin 
(specifying the current directory, /bin, and /usr/bbi, in that order). Note that the current 
directory is specified by a null path name, which can appear immediately after the equal sign or 
between the colon delimiters anywhere else in the path list. If the command name contains a / 
then the search path is not used; such commands will not be executed by the restricted shell. 
Otherwise, each directory in the path is searched for an executable file. If the file has execute per- 
mission but is not an a.out file, it is assumed to be a file containing shell commands. A sub-shell 
(i.e., a separate process) is spawned to read it. A parenthesized command is also executed in a 
sub-shell. 

The location in the search path where a command was found is remembered by the shell (to help 
avoid imnecessary execs later). If the command was found in a relative directory, its location 
must be re-determined whenever the current directory changes. The shell forgets all remembered 
locations whenever the PATH variable is changed or the hash -r command is executed (see 
below). 

Special Commands 

The following commands are executed in the shell process. Input/output redirection is permitted 
for these conmiands. File descriptor 1 is the default output location. 

: No eflFect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands fi-om file and return. The search path specified by 

PATH is used to find the directory containing file. Note that this command 
does not spawn another shell to execute file, and thus differs in behavior and 
output from executing file as a shell script. 

brealc [ n ] Ebdt from the enclosing for or while loop, if any. If n is specified then break n 
levels. 

continue [ n ] Resimie the next iteration of the enclosing for or while loop. If n is specified 
then resTune at the n-th enclosing loop. 

cd [ arg ] Change the current directory to arg. The shell parameter HOME is the default 

org. The shell parameter CDPATH defines the search path for the directory 
containing arg. Alternative directory names are separated by a colon (:). The 
default path is <null> (specifying the current directory). Note that the current 
directory is specified by a niill path name, which can appear immediately after 
the equal sign or between the colon delimiters anywhere else in the path list. If 
arg begins with a / the search path is not used. Otherwise, each directory in the 
path is searched for arg. The cd command may not be executed by rah. 

echo [ arg ... \ Echo arguments. See ecko{l) for usage and description. 

eval [ arg ... ] The argiunents are read as input to the shell and the resulting command(s) exe- 
cuted. 

exec [ arg . . . ] The command specified by the arguments is executed in place of this shell 
without creating a new process. Input /output argimients may appear and, if no 
other arguments are given, cause the shell input/output to be modified. 

exit [ n ] Causes a shell to exit with the exit status specified by n. If n is omitted then 

the exit status is that of the last command executed (an end-of-file will also 
cause the shell to exit.) 



export [ ruime 



The given names are marked for automatic export to the environment of 
subsequently-executed commands. If no argiiments are given, then a list of all 
names that are exported in this shell is printed. Function names may not be 
exported. 



Hewlett-Packard Company 



6- 



Version B.l, October 1986 



SH(1) HP-UX SH(1) 



haah '-••][ name 1 

For each name , the location in the search path of the command specified by 
name is determined and remembered by the shell. The -r option causes the shell 
to forget all remembered locations. If no argimients are given, information about 
remembered commands is presented. Hits is the niunber of times a command 
has been invoked by the shell process. Cost is a measure of the work required to 
locate a command in the search path. There are certain situations which require 
that the stored location of a command be recalculated. Commands for which 
this will be done are indicated by an asterisk (*) adjacent to the hits informa- 
tion. Coat will be incremented when the recalculation is done. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg See newgrp {!) for usage and description. 

pwd Print the CTurent working directory. See pwd{l) for usage and description. 

read [ name ... ] 

One line is read from the standard input and the first word is assigned to the 
first name, the second word to the second name, etc., with leftover words 
assigned to the last name. The return code is imless an end-of-file is encotm- 
tered. 

readonly [ name ... ] 

The given names are marked readonly and the values of the these names may 
not be changed by subsequent assigmnent. If no arguments are given, then a list 
of all readonly names is printed. 

return [ n ] Causes a function to exit with the return value specified by n. If n is omitted, 
the retmn status is that of the last command executed. 

set [ — aefhkntuvx [ arg ... ] ] 

—a Mark variables which are modified or created for export, 
-e EJxit inmiediately if a command exits with a non-zero exit status. 

-f Disable file name generation 

-h Locate and remember function commands as functions are defined (func- 
tion commands are normally located when the function is executed). 
-k All keyword arguments are placed in the environment for a command, 

not just those that precede the command name. 
-n Read commands but do not execute them. 
— t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 
-v Print shell input lines as they are read. 
-X Print commands and their arguments as they are executed. 
— Do not change any of the flags; useful in setting $1 to -. 
Using -I- rather than - causes these flags to be turned off. These flags can also 
be used upon invocation of the shell. The cm-rent set of flags may be foimd in 
$-. The remaining arguments are positional parameters and are assigned, in 
order, to $1, $2, — If no arguments are given then the values of all names are 
printed. 

shift [ n ] The positional parameters from Sn+l . . . are renamed $1 If n is not 

given, it is assmned to be 1. 

test Evaluate conditional expressions. See test{l) for usage and description. Note 

that "[ ... ]" in an if list is interpreted the same as "test ...". There must be 
blanks aroimd the brackets. 

times Print the accumulated user and system times for processes run from the shell. 

trap [ arg ][ n ] ... 

The command arg is a command to be read and executed when the shell receives 
signal(s) n. (Note that arg is scanned once when the trap is set and once when 
the trap is taken.) Trap commands are executed in order of signal nmnber. Any 
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type [ name . . . 
ulimit [ -f [ n 

umask [ nnn ] 
unset [ name . 

wait [ n ] 



attempt to set a trap on a signal that was ignored on entry to the current shell is 
ineffective. An attempt to trap on signal 11 (memory fault) or signal 18 (death 
of child) will produce an error. If arg is absent then all trap(s) n are reset to 
their original values. If arg is the null string then this signal is ignored by the 
shell and by the commands it invokes. If n is then the command arg is exe- 
cuted on exit from the shell. The trap command with no arguments prints a list 
of commands associated with each signal niunber. 

.] 

For each name, indicate how it would be interpreted if used as a command 
n£ime. 

]] 

If the -f n option is used, a size limit of n blocks is imposed on files written by 

child processes (files of any size may be read). With no argument, the current 

limit is printed. If no option is given, -f is assumed. 

The user file-creation mask is set to nnn (see umask{2)). If nnn is omitted, the 

current value of the mask is printed. 

••] 

For each name, remove the corresponding variable or function. The variables 
PATH, PSl, PS2, MAELCHECK and IFS cannot be unset. 
Wait for the specified process and report its termination status. If n is not given 
all currently active child processes are waited for and the return code is zero. 

Invocation 

If the shell is invoked through exec {2) and the first character of argument zero is -, commands 
are initially read from /etc/profile £ind then from $HOME/.profiIe, if such files exist. 
Thereafter, commands are read as described below, which is also the case when the shell is 
invoked as /bin/sh. The flags below are interpreted by the shell on invocation only; Note that 
xmless the -c or -s flag is specified, the first argument is assumed to be the name of a file contain- 
ing commands, and the remaining arguments are passed as positional parameters to that com- 
mand file: 

-c string If the -c flag is present then commands are read from string. 

-a If the -8 flag is present or if no argmnents remain then commands are read from the 

standeird input. Any remaining arguments specify the positional parameters. Shell 
output (except for Special Commands ) is written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a terminal, 

then this shell is interactive. In this case TERMINATE is ignored (so that kill does 
not kill an interactive shell) and INTERRUPT is caught and ignored (so that wait is 
interruptible). In all cases, QUIT is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described imder the set command above. 

Rsh Only 

Rsh is used to set up login names and execution environments whose capabilities are more con- 
trolled than those of the standard shell. The actions of rsh are identical to those of sh, except 
that the following are disallowed: 

changing directory (see cd(l)), 

settmg the value of SPATH, 

specifying path or conmiand names containing /, 

redirecting output (> and »). 

The restrictions above are enforced after .profile is interpreted. 

When a command to be executed is found to be a shell procedure, rsh invokes sh to execute it. 
Thiis, it is possible to provide to the end-user shell procedures that have access to the full power 
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of the standard shell, while imposing a limited menu of commands; this scheme assumes that the 
end-user does not have write and execute permissions in the same directory. 

The net effect of these rules is that the writer of the .profile has complete control over user 
actions, by performing guaranteed setup actions and leaving the user in an appropriate directory 
(probably not the login directory). 

The system «idministrator often sets up a directory of commands (i.e., /usr/rbin) that can be 
safely invoked by rsh. Some systems also provide a restricted editor red. 

FILES 

$HOME/.profile 
/dev/null 
/etc/profile 
/tmp/sh* 

RETURN VALUE 

The error codes returned by the shell are: 

- success; 

1 - a built-in command failure (see Special Commands); 

2 - syntax error; 

3 - signal received that is not trapped. 

If the shell is non-interactive, it will terminate and pass one of the above as its exit status. If it is 
interactive, it will not terminate, but $? will be set to one of the above values. 

Whenever a child process of the shell dies due to a signal, the shell returns an exit status of 80 
hexadecimal + the number of the signal. 

SEE ALSO 

acctcms(lM), acctcom(l), cd(l), echo(l), env(l), login(l), newgrp(l), pwd(l), test(l), umask(l), 
dup(2), exec(2), fork(2), pipe(2), 8ignal(2), ulimit(2), umask(2), wait(2), a.out(4), profile(4), 
environ(5). 

CAVEATS 

If a conamand is executed, and a command with the same name is installed in a directory in the 
sejirch path before the directory where the original command was found, the shell will continue to 
exec the original command. Use the hash command to correct this situation. 

When the shell encoimters >>, it does not open the file in append mode. Instead, it opens the file 
for writing and seeks to the end. If you move the current directory or one above it, pwd may not 
give the correct response. Use the cd command with a full path name to correct this situation. 

The command readonly (without arguments) produces the same output as the command 
export. 

INTERNATIONAL SUPPORT 

sh: 8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

shl - shell layer manager 

SYNOPSIS 
shl 

DESCRIPTION 

Shl enables a user to access and interact with two or more shells from a single terminal. These 
shells, known as layers , are controlled by using the commands described below. 

The current layer is the layer which can receive input from the keyboard. Other layers attempt- 
ing to read from the keyboard are blocked. Output from multiple layers is multiplexed onto the 
terminal. To have the output of a layer blocked when it is not current, the stty option loblk may 
be set within the layer. 

The stty character swtch (set to *Z if NUL) is used to switch control to shl from a layer. Shl has 
its own prompt, >», to help distinguish it from a layer. 

A layer is a shell which has been bound to a pseudo tty device (/dev/pty/tty??). The pseudo 
device can be manipulated like a real tty device using stty{l) and ioctl{2). Each layer has its own 
process group id. 

Definitions 

A name is a sequence of characters delimited by a blank, tab or new-line. Only the first eight 
characters are significant. The names (1), through (2), ... are used. Names can be abbreviated 
to just the digit. 

Commands 

The following commands may be issued from the shl prompt level. Any imique prefix is accepted. 

create name Create a layer called name and make it the current layer. If 

no argument is given, a layer is created with a name of the 
form f# j where # is the number of the next available slot in 
an internal table. The shell prompt variable PSl is set to the 
name of the layer followed by a space. The number of layers 
that can be created is dependent on the nmnber of available 
pseudo- terminals. 



block name [ name ... ] 



delete name name 



For each name, block the output of the corresponding layer 
when it is not the current layer. This is equivalent to setting 
the stty option loblk within the layer. 

For each name, delete the corresponding layer. All processes 
in the process group of the layer are sent the SIGHUP signal 
(see signal{2)). 
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help or ? 
layers -1 name ... 

resume name 

toggle 

unblock name [ name 

quit 

name 



Print the syntax of the shl commands. 

For each name, list the layer name and its process group. The 
-1 option produces a ps(l)-like listing. If no arguments are 
given, information is presented for all existing layers. 

Make the layer referenced by name the current layer. If no 
argiunent is given, the last existing current layer will be 
resumed. 

Resume the layer that was ciurent before the last current 
layer. 

For each name, do not block the output of the corresponding 
layer when it is not the current layer. This is equivalent to 
setting the stty option -loblk within the layer. 

Exit shl. Sends the SIGHUP signal to all layers. 

Make the layer referenced by name the ciu-rent layer. 



FILES 



/dev/pty/tty?? Pseudo tty devices 

SSHELL Variable containing path name of the shell to use (default is /bin/ ah). 

SEE ALSO 

sh(l), stty(l), ioctl(2), signal(2), pty(7). 
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NAME 

size - print section sizes of object files 

SYNOPSIS 

size [-d] [-o] [-x] [-V] files 

DESCRIPTION 

The size command produces section size information for each section in the object files. The size 
of the text, data and bss (iminitialized data) sections are printed along with the total size of the 
object file. If an archive file is input to the size command, the information for all archive 
members is displayed. 

Numbers will be printed in decimal unless either the -o or the -x option is used, in which case 
they will be printed in octal or in hexadecimal, respectively. 

The -V flag will supply the version information on the size command. 

HARDWARE DEPENDENCIES 

Series 200, 300 

The -V option is not supported. 

Series 500 

The -V option is not supported. 

The text size shown is the sum of the sizes of all code segments. 

The data size shown is the sum of the initialized portions of the ddata and idata segments 
(which may be one or two data segments). 

The bss size shown is the stim of the uninitialized portions of the ddata and idata segments. 

If size is run on any commands shipped with HP-UX, the text size does not include any 
shared library segments referenced by the command. 

Series 800 

Size information is printed for each subspace in the object file. Each subspace size is fol- 
lowed by the subspace name in parentheses. 

SEE ALSO 

as(l), cc(l), ld(l). a.out(4), ar(4). 

DIAGNOSTICS 

size: name: cannot open if name c&nnot be read. 

size: name: bad magic if name is not an appropriate object file. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a command after a certain 
amount of time, as in: 

(sleep 105; command)ic 

or to execute a command every so often, as in: 

while true 
do 

command 

sleep 37 
done 

SEE ALSO 

alarm(2), sleep(3C). 

BUGS 

32 

Time must be less than 2 seconds. 
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NAME 

sip - set the options for a printer 

SYNOPSIS 

sip [-a] [-b] [-ccols] [-d] [-1 indent] [-1 lines] [-n] [-C pages] [-0 pages] 

DESCRIPTION 

Sip sets printer status information such as the nmnber of lines per page, the number of characters 
per line, and the indentation. These characteristics are controlled by the printer drive as 
described in /p(7). Sip acts on the ciurent standard output. 

The meanings of the options are: 

-a Reports all of the option settings. 

-b Indicates that this is a character printer; back spaces are to pass through the driver 

tmchanged. The absence of this option indicates a line printer. The driver takes the 
necessary action to accommodate a backspace character. 

-c cols Cols selects the number of columns to be printed. Characters beyond the last specified 
column will be truncated. 

-d Resets options to the defaults for the device. (This action is not taken until the next 

open occurs on the device.) 

-i indent Indent selects the nmnber of columns to mdent before the first printed column. 

-1 lines Lines selects the number of lines per page. The last new-line character of each page will 
be changed to a form-feed. 

-n Set the page size to infinity. (Since the last new-line of the page is never encoimtered, 

no new-line characters will be changed to form-feeds.) 

-C pages Zero or more pages may be ejected after the final close of the device. 

-O pages Zero or more pages may be ejected as the device is opened. 

EXAMPLE 

A tvnir.al csisp is to set the printer to 80 columns no indentation and no form-feeds betv-'sen 
pages: 

sip -c80 -iO -n >/dev/lp 

HARDWARE DEPENDENCIES 

Integral PC 

This command is not available. Refer to the Integral Personal Computer Programmer's 
Guide for more information about the Ip implementation on the Integral PC. 

Series 200, 300 

The value of cols will be forced into the range of 1 to 227, the value of indent from to 227, 
and the value of lines from 1 to MAXSHORT. The -b, -C, and -O options are not sup- 
ported. 

The uppercase-only flag, the no-overprint flag, the raw-mode flag, and no-page-eject-on- 
open-or-close flag can be selected (enabled) by appropriate use of the minor n\miber in the 
mknod{lM) command. See the HP-UX System Administrator Manual for details. 

Series 500 

This command is not available. However the nmnber of characters per line (80 or 132) and 
wrap-around can be selected (enabled) via the minor nmnber in the mknod(iM.) command. 
See the HP-UX System Administrator Manual for details. 

AUTHOR 

Sip was developed by the Hewlett-Packard Company. 
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SEE ALSO 

ioctl(2), lp(7). 
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NAME 

sort - sort and/or merge files 

SYNOPSIS 

sort [ [-emu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnrl] [-tbx] [+posl [-pos2]]] [files] 

DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on the standard output. The 
standard input is read if - is used as a file name or no input files are named. 

Comparisons are based on one or more sort keys extracted from each line of input. By default, 
there is one sort key, the entire input line, and ordering is lexicographic by bytes in machine col- 
lating sequence. 

International Support: Specifying the -1 option causes sorting to be performed using the collation 
sequence associated with the specified language. If the language is not specified or is set to 
n computer, the ordering is lexicographic by bytes in machine-collating sequence. 

If the user's language includes two-byte characters, one-byte characters are machine-collated 
before two-byte characters. 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering rules; give no output 

imless the file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal keys. 

-ooutput The argument given is the name of an output file to use instead of the standard 

output. This file may be the same as one of the inputs. There may be optional 
blanks between -o and output. 

-ykmem The amount of main memory used by the sort has a large impact on its perfor- 

mance. Sorting a small file in a large amount of memory is a waste. If this 
option is omitted, sort begins using a system default memory size, and continues 
to use more space as needed. If this option is presented with a value, kmem, sort 
will stEirt using that nmnber of kilobytes of memory, unless the administrative 
minimmn or maximum is violated, in which case the corresponding extremum 
will be used. Thus, -yO is guaranteed to start with minimum memory. By con- 
vention, -y (with no argimient) starts with maximmn memory. 

-zrecsz The size of the longest line retid is recorded in the sort phase so buffers can be 

allocated during the merge phase. If the sort phase is omitted via the -c or -m 
options, a popular system default size will be used. Lines longer than the buffer 
size will cause sort to terminate abnorm£illy. Supplying the actual munber of 
bytes in the longest line to be merged (or some larger value) will prevent abnor- 
mal termination. 

The following options override the default ordering rules. 

-d "Dictionary" order: only letters, digits and blanks (spaces and tabs) are 

significant in comparisons. 

-f Fold lowercase letters into uppercase. The -f option is ignored if a language 
other than n computer is specified. 

-i Ignore characters outside the ASCII range 040-0176 in non-numeric comparisons. 
The -i option will be ignored if a language other than n computer is specified. 
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-M Compare as months. The first three non-blank characters of the field are folded 

to uppercase and compared so that "JAN" < "FEB" < . . . < "DEC". Invalid 
field compare low to "JAN". The -M option implies the -b option (see below). 

-n An initial niuneric string, consisting of optional blanks, optional minus sign, and 

zero or more digits with optional decimal point, is sorted by arithmetic value. 
The -n option implies the -b option (see below). Note that the -b option is 
only effective when restricted sort key specifications are in effect. 

— r Reverse the sense of comparisons. 

The following option applies to International Support (see above). 

-1 Collate characters using the collation rules associated with the user's LANG vari- 

able, see envtron{5). 

When ordering options appear before restricted sort key specifications, the requested ordering 
rules are applied globally to all sort keys. When attached to a specific sort key (described below), 
the specified ordering options override all global ordering options for that key. 

The notation +posl -pos2 restricts a sort key to one beginning at poal and ending at pos2. The 
characters at positions poal and pos2 are included in the sort key (provided that pos2 does not 
precede posl). A missing —pos2 means the end of the line. 

Specifying posl and pos2 involves the notion of a field, a minimal sequence of characters followed 
by a field separator or a new-line. By default, the first blank (space or tab) of a sequence of 
bleinks acts as the field separator. All blanks in a sequence of blanks are considered to be peirt of 
the next field; for example, all blanks at the beginning of a line are considered to be part of the 
first field. The treatment of field separators can be altered using the options: 

-tx Use X as the field separator character; x is not considered to be part of a field 

(although it may be included in a sort key). Each occurrence of x is significant 
(e.g., XX delimits an empty field). 

-b Ignore leading blanks when determining the starting and ending positions of a 

restricted sort key. If the -b option is specified before the first +posl argmnent, 
it will be applied to all +posl argmnents. Otherwise, the b flag may be 
attached independently to each +posl or -pos2 argument (see below). 

Posl and pos2 each have the form m.n optionally followed by one or more of the flags bdfinr. A 
starting position specifled by +m.n is interpreted to mean the n-f-lst character in the m-|-lst 
field. A missing .n means .0, indicating the first character of the m-|-lst field. If the b flag is in 
effect n is coimted from the first non-blank in the m-|-lst field; -|-m.Ob refers to the first non- 
blank character in the m-|-lst field. 

A last position specified by —m.n is interpreted to mean the nth character (including separators) 
after the last character of the m th field. A missing .n means .0, indicating the last character of 
the mth field. If the b flag is in effect n is counted from the last leading blank in the m-|-lst field; 
-m.lb refers to the first non-blank in the m-l-lst field. 

When there are multiple sort keys, later keys are compared only after aJl earlier keys compare 
equal. Lines that otherwise compare equal are ordered with all bytes significant. 

EXAMPLES 

Sort the contents of infile with the second field as the sort key: 

sort -1-1-2 infile 

Sort, in reverse order, the contents of infilel and infile2, placing the output in outfile and using 
the first character of the second field as the sort key: 
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sort -r -o outfile +1.0 -1.2 infilel iiifile2 

Sort, in reverse order, the contents of infilel and infileS using the first non-blank character of the 
second field as the sort key: 

sort -r +1.0b -1.1b infilel infile2 

Print the password file {passwd{4)) sorted by the numeric user ID (the third colon-separated 
field): 

sort -t: -|-2n -3 /etc/passwd 

Print the lines of the already sorted file infile, suppressing all but the first occurrence of lines hav- 
ing the same third field (the options -um with just one input file make the choice of a imique 
representative from a set of equal lines predictable): 

sort -um +2 -3 infile 

FILES 

/usr/tmp/stm??? 

SEE ALSO 

comm(l), join(l), uniq(l), col seq_8(4), environ(5), hpnls(5), langid(5). 

DIAGNOSTICS 

Comments and exits with non-zero status for various trouble conditions (e.g., when input lines are 
too long), and for disorder discovered under the -c option. When the last line of an input file is 
missing a new-line character, sort appends one, prints a warning message, and continues. 

If there is an error in accessing the tables containing the collation rules for the specified language, 
sort prints a warning message and defaults to n computer. 

The -d option recognizes ASCII characters only. If a language other than n ^computer is 

specified with the -d option, sort prints a warning message and defaults to n ^computer. 

The -M option compares American month names only. If a language other than n ^computer is 

specified with the -M option, sort prints a warning message and defaults to n ^computer. 

The -n option only recognizes the English radix character (decimal point) in nimieric comparis- 

«».c It r» ^,^■,^rr,,^^^ ^4^l^>^> l-knn .. ^n,^-^-.-.* n- !« „«««;C I ...H-U 4-1 tl t :_*.„ _ 1 

KfXXO* XX CX ICXlX^tXCXf^^ UliXXVl KXXOUX XJ ^WXXXf^lXt<CX lO 0^>i;\^XXiCVX VVlbXX bllC ~Uk U^lflUlX, OVIl ^XllltS <1 W <U lllll|^ 

message and defaults to n computer. 

BUGS 

When using the specified ordering option(s) with two-byte characters, poal and pos8 must specify 
byte position, not character position. 

The -t option only recognizes a character encoded in one byte as a field separator character. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

spell, hashmake, spellin, hashcheck - find spelling errors 

SYNOPSIS 

spell [ -V ] [ -b ] [ -X ] [ -1 ] { -i ] [ -{-local file ][ files ] 

/usr/lib/spell/hashmake 

/usr/lib/apell/spellin n 

/usr/lib/spell/hashcheck spellin g l ist, 

DESCRIPTION 

Spell collects words from the named files and looks them up in a spelling list. Words that neither 
occur among nor are derivable (by applying certain inflections, prefixes, and/or suflBxes) from 
words in the spelling list are printed on the standard output. If no files are named, words are col- 
lected from the standard input. 

5pcW ignores most troff, tbl{i), and eqn constructions. 

Options 

-V All words not literally in the spelling list are printed, and plausible derivations 

from the words in the spelling list are indicated. 

-b British spelling is checked. Besides preferring centre, colour, programme, speci- 

ality, travelled, etc., this option insists upon -ise in words like standardise. 

-X Every plausible stem is printed with = for each word. 

By default, spell (like deroff{\)) follows chains of included files (.so and .nx fro^ requests), unless 
the names of such included files begin with /usr/lib. Under the -1 option, spell will follow the 
chains of all included files. Under the -i option, spell will ignore all chains of included files. 

Under the -^local—file option, words found in local— file are removed from spell's output. 
Local— file is the name of a user-provided file that contains a sorted list of words, one per line. 
With this option, the user can specify a set of words that are correct spellings (in addition to 
spelVa own spelling list) for each job. 

The spelling list is based on many sources, and while more haphazard than an ordinary diction- 
ary, is also more effective with respect to proper names and popular technical words. Coverage of 
the specialized vocabularies of biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated below with their default 
settings (see FILES). Copies of all output are accimiulated in the history file. The stop list filters 
out misspellings (e.g., thier=thy-y-f-ier) that would otherwise pass. 

Three routines help maintain and check the hash lists used by spell: 

hashmake Reads a list of words from the standard input and writes the corresponding 

nine-digit hash code on the standard output. 

spellin n Reads n hash codes from the standard input and writes a compressed spelling list 

on the standard output. Information about the hash coding is printed on stan- 
dard error. 

hashcheck Reads a compressed spelling— list and recreates the nine-digit hash codes for all 

the words in it; it writes these codes on the standard output. 
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EXAMPLES 

The following example creates the hashed spell list hlist eind checks the resvilt by comparing the 
two temporary files; they should be equal. 

cat goodwds | /usr/lib/spell/hashmake | sort -u >tmpl 
cat tmpl I /usr/lib/spell/spellin ^ cat tmpl | wc -b >hlist 
cat hlist I /usr/lib/spell/hashcheck >tmp2 
diff tmpl tmp2 

WARNINGS 

The spelling list's coverage is uneven. New installations will probably wish to monitor the output 
for several months to gather local additions. Typically, these are kept in a separate local file that 
is added to the hashed spelling— list via spellin. 



FILES 



The British spelling feature was done by an American. 

D_SPELL=/usr/lib/spell/hlist[ab] hashed spelling lists, American & British 

S_SPELL=/usr/lib/spell/hstop hashed stop list 

H_SPELL=/usr/lib/spell/spellhist history file 

/usr/lib/spell/spellprog program 

VARIABLES 

D_SPELL Your hashed spelling list. (Default as above.) 

H_SPELL Spelling history. (Default as above.) 

S_SPELL Your hashed stop list. (Default as above.) 

SEE ALSO 

deroff(l), sed(l), sort(l), tbl(l), tee(l). 
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NAME 

split - split a file into pieces 

SYNOPSIS 

split [ -n ] [ file [ name ] ] 

DESCRIPTION 

Split reads file and writes it in n-line pieces (default 1000 lines) onto a set of output files. The 
naxae of the first output file is name with aa appended, and so on lexicographically, up to zz (a 
maximum of 676 files). Name cannot be longer than 12 characters. If no output name is given, x 
is default. 

If no input file is given, or if - is given instead, then the standard input file is used. 

SEE ALSO 

bfs(l), csplit(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

sqlutil - ALLBASE/HP-UX DBCore utilities 

SYNOPSIS 

sqlutil 

REMARKS 

The ALLBASE/HP-UX product must be previously installed on the system for sqlutil to function. 

DESCRIPTION 

Sqlutil invokes the DBCore utility program for maintaining and reconfiguring an ALLBASE/HP- 
UX relational DataBase Environment (DBEnvironment). There are no options available with this 
command. Sqlutil can be executed by «dl system users on all DataBase Environment 
Configuration (DBECon) files created by them. 

AUTHOR 

Sqlutil was developed by Hewlett-Packfird. 

FILES 

/usr/bin/hpdbdaemon cleanup daemon program file 

/usr/lib/hpsqlproc HP SQL program file 

/usr/bin/sqlutil SQLUTIL program file 

/usr/lib/hpsqlcat HP SQL message catalog file 

SEE ALSO 

ALLBASE/HP-UX SQL Reference Manual. 
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NAME 

8sp - remove multiple line-feeds from output 

SYNOPSIS 
ssp 

DESCRIPTION 

Ssp (single-space) removes redundant blank lines from the standard input and sends the result to 
the standard output. It is typically used in pipelines like 

nroflf -ms filel I ssp 

Ssp is equivalent to the 4.2BSD cat -s command. 

SEE ALSO 

cat(l), rmnl(l). 
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NAME 

strings - find the printable strings in an object, or other binary, file 

SYNOPSIS 

strings [ -a ] [ -o ] [ -number ] [ file ] ... 

DESCRIPTION 

Strings looks for ascii strings in a file. If no files are specified, stdin is used. A string is any 
sequence of 4 or more printing characters ending with a new-line or a null. 

The following flags are defined. 

a By default, strings only looks in the initialized data space of object files (as 

recognised by their magic numbers). If this flag is used, the whole file is 
inspected. This flag is always set if stdin is being read or the file is not recog- 
nized as an object file. For backward compatibility, - is taken as a synonym for 
-a. 

o Each string is preceded by its off^set in the file (in octal), number number is used 

as the minimmn string length rather than 4. 

Strings is useful for identifying random object files and many other things. 

AUTHOR 

Strings was developed by the University of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

od(l) 

BUGS 

The algorithm for identifying strings is extremely primitive. 
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NAME 

strip - remove symbols and debug information 

SYNOPSIS 

strip name ... 

DESCRIPTION 

Strip removes the symbol table and debug information from an executable object file. Once this is 
done, no symbolic debugging access will be available for that file; therefore this command is nor- 
mally nm only on production modules that have been debugged and tested. The effect is the 
same as use of the -a option of Id. 

If name is a relocatable file, strip removes the debug information. 

If the strip command is executed on an archive file (see ar (5)) the archive symbol table will be 
removed. The archive symbol table must be restored by executing the ar (1) command with the s 
option before the archive can be link-edited by the Id (1) command. Also, strip removes the debug 
information from any a. out file it finds in the archive. 

The purpose of this command is to reduce the file storage overhead taken by the object file. 

HARDWARE DEPENDENCIES 

Series 200: 

If name is a relocatable file, strip will remove the local symbols from it. If name is an 
archive file, strip will remove the local symbols from any a. out format files it finds in the 
archive. Certain libraries, such as those residing in /lib, have no need for local symbols. 
By deleting them, the size of the archive is decreased and link editing performance is 
increased. 

FILES 

/tmp/s* temporary files 

SEE ALSO 

ar(l), ld(l), ar(5), a.out(5). 
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NANfE 

strip - strip symbol and line niunber information from an object file 

SYNOPSIS 

strip [-1] [-x] [-r] [-V] filename 

DESCRIPTION 

The strip command stripe the symbol table and line nmnber information from object files, includ- 
ing archives. Once this has been done, no symbolic debugging access will be available for that file; 
therefore, this command is normally run only on production modules that have been debugged 
and tested. 

The amoimt of information stripped from the symbol table can be controlled by using any of the 
following options: 

-1 Strip line number information only; do not strip any symbol table information. 

-X Do not strip static or external symbol information. 

-r Reset the relocation indexes into the symbol table. 

-V Print the version of the strip command executing on the standard error output. 

If there are any relocation entries in the object file and any symbol table information is to be 
stripped, strip will complain and terminate without stripping file-name imless the -r flag is used. 

If the strip command is executed on an archive file (see or (4)) the archive symbol table will be 
removed. The archive symbol table must be restored by executing the ar(l) command with the s 
option before the archive can be link-edited by the W(l) command. Strip will instruct the user 
with appropriate warning messages when this situation arises. 

The purpose of this command is to reduce the file storage overhead taken by the object file. 

HARDWARE DEPENDENCIES 

Series 800 

The -1 and -x options are synonymous, since the symbol table contains only static and 
external symbols. Either option causes only symbolic debugging information to be 
stripped. The -r option allows strip to be run on relocatable files, in which case the effect 
is also to strip only symbolic debugging information. 

FILES 

/usr/tmp/strp?????? 

SEE ALSO 

ar(l), as(l), cc(l), ld(l), a.out(4), ar(4). 

DIAGNOSTICS 

strip: name: cannot open if name cannot be read. 

strip: name: bad magic if name is not an appropriate object file. 

strip: name: relocation entries present; cannot strip 

if name contains relocation entries and the -r flag is not used, 
the symbol table information cannot be stripped. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

stty 

SYNOPSIS 

stty [ -a I -g 

DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current standard input; without 
arguments, it reports the settings of certain options; with the -a option, it reports all of the 
option settings; with the -g option, it reports current settings in a form that can be used as an 
argument to another stty command. Detailed information about the modes listed in the first five 
groups below may be foimd in termio{7) for asynchronous lines. Options in the last group are 
implemented using options in the previous groups. Note that many combinations of options make 
no sense, but no sanity checking is performed. The options are selected from the following- 
Control Modes 

parenb (-parenb) enable (disable) parity generation and detection. 

parodd (-parodd) select odd (even) parity. 

C85 cs6 cs7 cs8 select character size (see termio(7)). 

hang up phone line immediately. 

50 75 110 134.5 150 200 300 600 900 1200 

1800 2400 3600 4800 7200 9600 19200 38400 exta extb 

Set terminal baud rate to the number given, if possible. (Some speeds are 

not supported by all hardware interfaces.) 

hang up (do not hang up) modem cormection on last close. 

same as hupcl (-hupcl). 

use two (one) stop bits per character. 

enable (disable) the receiver. 

enable (disable) request-to-send. 

assume a line without (with) modem control. 



hupcl (-hupcl) 

hup (-hup) 

cstopb (-cstopb) 

cread (-cread) 

crts (-crts) 

clocal (-clocal) 

Input Modes 

ignbrk (-ignbrk) 

ienqak (-ienqak) 

brkint (-brkint) 

ignpar (-ignpar) 



ignore (do not ignore) break on input. 

enable (disable) ENQ-ACK handshaking. 

signal (do not signal) INTR on break. 

ignore (do not ignore) parity errors. 

parmrk (-parmrk) mark (do not mark) parity errors (see termio{7)). 

inpck (-inpck) enable (disable) input parity checking. 

istrip (-istrip) strip (do not strip) input characters to seven bits. 

inlcr (-inlcr) map (do not map) NL to CR on input. 

igncr (-igncr) ignore (do not ignore) CR on input. 

icml (-icml) map (do not map) CR to NL on input. 

iuclc (-iuclc) map (do not map) upper-case alphabetics to lower case on input. 

ixon (-ixon) enable (disable) START/STOP output control. Output is stopped by send- 

ing an ASCII DC3 and started by sending an ASCII DCl. 

ixany (-ixany) allow any character (only DCl) to restart output. 

ixoff (-ixoff) request that the system send (not send) START/STOP characters when the 

input queue is nearly empty /full. 
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Output Modes 
opost (-opost) 

olcuc (-olcuc) 
onlcr (-onlcr) 
ocrnl' (-ocrnl) 
onocr (-onocr) 
onlret (-onlret) 
ofiU (-ofill) 
ofdel (-ofdel) 
crO crl cr2 cr3 
nlO nil 
tabO tabl tab2 tabS 

bsO bsl 
ffOffl 
vtO vtl 

Local Modes 

isig (-islg) 

icanon (-icanon) 
xcase (-xcase) 
echo (-echo) 
echoe (-echoe) 



post-process output (do not post-process output; ignore all other output 



echok (-echok) 
Ifkc (-Ifkc) 
echonl (-echonl) 
noflsh (-noflsh) 
tostop (-tostop) 



Control Assignments 

control-character c 



map (do not map) lower-case alphabetics to upper case on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at colmnn zero. 

on the terminal NL performs (does not perform) the CR function. 

use fill charsicters (use timing) for delays. 

fill characters are DELs (NULs). 

select style of delay for carriage returns (see termio{7)). 

select style of delay for line-feeds (see termio{7)). 

select style of delay for horizontal tabs (see termio{7). 
select style of delay for backspaces (see termio{7)). 
select style of delay for form-feeds (see termio{7)). 
select style of delay for vertical tabs (see termio{7)). 

enable (disable) the checking of characters against the special control char- 
acters INTR and QUIT. 

enable (disable) canonical input (ERASE and KILL processing). 

canonical (unprocessed) upper /lower-case presentation. 

echo back (do not echo back) every chciracter typed. 

echo (do not echo) ERASE character £is a backspace-space-backspace string. 
Note: this mode wiii erase the ERASEed character on many CRT terminals; 
however, it does not keep track of column position £md, as a result, may be 
confusing on escaped characters, tabs, and backspaces. 

echo (do not echo) NL after KILL character. 

the same as echok (—echok); obsolete. 

echo (do not echo) NL. 

disable (enable) flush after INTR or QUIT. 

enable (disable) generation of SIGTTOU signals when background jobs 
attempt output. This flag is ignored on those systems which do not sup- 
port job control. 

set control-character to c, where control-character is erase, kill, intr, 
quit, eof, eol, min, or time (min and time are used with -icanon; see 

termio{7)). For those systems which support job control, susp and dsusp 
charsicters may also be set. If c is preceded by an (escaped from the shell) 
caret ('), then the value used is the corresponding CTRL character (e.g., 
"'d" is a CTRL-d); ""?" is interpreted as DEL and "'-" is interpreted as 
undefined. 
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line I set line discipline to i (0 < i < 127 ). (See fermzo(7)). 

Combination Modes 

evenp or parity enable parenb and csT. 

oddp enable parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

disable parenb, and set cs8. 

raw (-raw or cooked) 

enable (disable) raw input and output (no ERASE, KILL, INTR, QUIT, EOT, 
or output post processing). 

nl (-nl) imset (set) icrnl, onlcr. In addition -nl unsets inlcr, igncr, ocrnl, and 

onlret. 

lease (-lease) set (unset) xease, iuele, and oleue. 

LCASE (-LCASE) same as lease (-lease). 

tabs (-tabs or tabS) preserve (expand to spaces) tabs when printing. 

ek reset ERASE and KILL characters back to normal # and 

sane resets all modes to some reasonable values. 

term set all modes suitable for the terminal type term, where term is one of 

tty33, tty37, vt05, tn300, ti700, hp, 

HARDWARE DEPENDENCIES 

Series 200, 300, 500: 

Job control is not supported. Refer to the HARDWARE DEPENDENCIES section of 
termio(7) for a further description of the capabilities that are not supported. 

SEE ALSO 

tabs(l), ioctl(2), termio(7). 

INTERNATIONAL SUPPORT 

8-bit data. 
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NAME 

stty - set the options for a terminal port 

SYNOPSIS 

stty [ -a I -g I options ] 

DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current standard input; without 
arguments, it reports the settings of certain options; with the -a option, it reports all of the 
option settings; with the -g option, it reports current settings in a form that can be used as an 
argument to another stty command. Detailed information about the modes listed in the first five 
groups below may be foimd in termio{7) for asynchronous lines. Options in the last group are 
implemented using options in the previous groups. Note that many combinations of options make 
no sense, but no sanity checking is performed. The options are selected from the following: 
Control Modes 

parenb (-parenb) enable (disable) parity generation £ind detection. 

parodd (-parodd) select odd (even) parity. 

C85 C86 csT csS select character size (see termio(7)). 

hang up phone line immediately. 

50 75 110 134.5 150 200 300 600 900 1200 

1800 2400 3600 4800 7200 9600 19200 38400 exta extb 

Set terminal baud rate to the number given, if possible. (Some speeds are 

not supported by all hardware interfaces.) 

hang up (do not hang up) modem cormectiou on last close. 

same as hupcl (-hupcl). 

use two (one) stop bits per character. 

enable (disable) the receiver. 

enable (disable) request-to-send. 

assume a line without (with) modem control. 

enable (disable) layer output blocking. 



hupcl (-hupcl) 

hup (-hup) 

cstopb (-cstopb) 

cread (-cread) 

crts (-crts) 

clocal (-clocal) 

loblk (-loblk) 

Input Modes 

ignbrk (-ignbrk) 

ienqak (-ienqak) 

brkint (-brkint) 

ignpar (-ignpar) 



ignore (do not ignore) break on input, 
enable (disable) ENQ-ACK handshaking, 
signal (do not signal) INTR on break, 
ignore (do not ignore) parity errors. 



parmrk (-parmrk) mark (do not mark) parity errors (see termio{7)). 

inpck (-inpck) enable (disable) input parity checking. 

istrip (-istrip) strip (do not strip) input characters to seven bits. 

inlcr (-inlcr) map (do not map) NL to CR on input. 

igncr (-igncr) ignore (do not ignore) CR on input. 

icrnl (-icml) map (do not map) CR to NL on input. 

iuclc (-iuclc) map (do not map) upper-case alphabetics to lower case on input. 

ixon (-ixon) enable (disable) START/STOP output control. Output is stopped by send- 
ing an ASCII DC3 and started by sending an ASCII DCl. 

ixany (-ixany) allow any character (only DCl) to restart output. 
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ixoff (-ixofl) 

Output Modes 
opost (-opost) 

oicuc (-olcuc) 
onlcr (-onlcr) 
ocrnl (-ocrnl) 
onocr (-onocr) 
onlret (-onlret) 
ofiU (-ofiU) 
ofdel (-ofdel) 
crO crl cr2 cr3 
nlO nil 
tabO tabl tab2 tabS 

bsObsl 

ffOffl 

vtO vtl 

Local Modes 
Isig (-isig) 

icanon (-icanon) 
xcase (-xcase) 
echo (-echo) 
echoe (-echoe) 



echok (-echok) 
Ifkc (-Ifkc) 
echonl (-echonl) 
noflsh (-noflsh) 
tostop (-tostop) 



Control Assignments 

control-character c 



request that the system send (not send) START/STOP characters when the 
input queue is nearly empty /full. 

post-process output (do not post-process output; ignore all other output 
modes). 

map (do not map) lower-case alphabetics to upper case on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at column zero. 

on the terminal NL jjerforms (does not perform) the CR function. 

use fill characters (use timing) for delays. 

fill characters are DELs (NULs). 

select style of delay for carriage returns (see termio{7)). 

select style of delay for line-feeds (see termto{7)). 

select style of delay for horizontal tabs (see termio{7). 
select style of delay for backspaces (see termio{7)). 
select style of delay for form-feeds (see termio{7)). 
select style of delay for vertical tabs (see termio{7)). 

enable (disable) the checking of characters against the special control char- 
acters INTR and QUIT. 

enable (disable) canonical input (ERASE and KILL processing). 

canonical (unprocessed) upper/lower-case presentation. 

echo back (do not echo back) every character typed. 

echo (do not echo) ERASE character as a backspace-space-backspace string. 
Note: this mode will erase the ERASEed character on many CRT terminals; 
however, it does not keep track of column position and, as a result, may be 
confusing on escaped characters, tabs, and backspaces. 

echo (do not echo) NL after KILL character. 

the same as echok (-echok); obsolete. 

echo (do not echo) NL. 

disable (enable) flush after INTR or QUIT. 

enable (disable) generation of SIGTTOU signals when background jobs 
attempt output. This flag is ignored on those systems which do not sup- 
port job control. 

set control-character to c, where control-character is erase, kill, intr, 
quit, eof, eol, swtch (used with shell layers), min, or time (min and 
time are used with -icanon; see termio{7)). For those systems which 
support job control, susp and dsusp characters may also be set. If c is 
preceded by an (escaped from the shell) caret ('), then the value used is 
the corresponding CTRL character (e.g., ""d" is a CTRL-d); "*?" is 
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interpreted as DEL and ""-" is interpreted as undefined. 

line i set line discipline to i (0 < z < 127 ). (See termio{7)). 

Combination Modes 

evenp or parity enable parenb eind csT. 

oddp enable parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

disable parenb, and set cs8. 

raw (-raw or cooked) 

enable (disable) raw input and output (no ERASE, KILL, INTR, QUIT, EOT, 
or output post processing). 

nl (-nl) unset (set) icrni, onlcr. In addition -nl unsets inlcr, igncr, ocrnl, and 

onlret. 

lease (-lease) set (unset) xease, iuele, and oleuc. 

LCASE (-LCASE) same as lease (-lease). 

tabs (-tabs or tabS) preserve (expand to spaces) tabs when printing. 

ek reset ERASE and KILL characters back to normal # and 

sane resets all modes to some reasonable values. 

term set all modes suitable for the terminal type term, where term is one of 

tty33, tty37, vt05, tnSOO, ti700, hp, 

HARDWARE DEPENDENCIES 

Series 200, 300, 500: 

Job control is not supported. Refer to the HARDWARE DEPENDENCIES section of 
termio{7) for a further description of the capabilities that are not supported. 

SEE ALSO 

tabs(l), ioctl(2), termio(7). 

INTERNATIONAL SUPPORT 

8-bit data. 
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NAME 

su - become sup>er-user or another user 

SYNOPSIS 

su [ - ] [ name [ arg • • • ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. The default user name is root (i.e., 
super-user). 

To use su, the appropriate password must be supplied (imless one is already root). If the pass- 
word is correct, su will execute a new shell with the real and effective user ID, real and effective 
group ID, and group access list set to that of the specified user. The new shell will be the optional 
program najned in the shell field of the specified user's password file entry (see passwd(4)). or 
/bin/sh if none is specified (see 5/1(1)). To restore normal user ID privileges, type an EOF to the 
new shell. 

Any additional arguments given on the command line axe passed to the program invoked as the 
shell, permitting the super-user to nm shell procedures with restricted privileges. When using 
programs like 5/1(1), an arg of the form -c string executes string via the shell and an arg of -r 
will give the user a restricted shell. 

The following statements are true only if the optional program named in the shell field of the 
specified user's password file entry is like sh{l). If the first argument to su is a -, the environ- 
ment will be changed to what would be expected if the user actually logged in as the specified 
user. This is done by invoking the program used as the shell with an argO value whose first char- 
acter is -, thus causing first the system's profile (/etc/profile) and then the specified user's 
profile (.profile in the new HOME directory) to be executed. Otherwise, the environment is 
passed along unchanged, except that SPATH, is unconditionally set to /bin:/etc:/u8r/bin for 
root. Note that if the optional progrsim used as the shell is /bin/sh, the user's .profile can 
check argO for -sh or -su to determine if it was invoked by login{l) or 5«(1), respectively. If the 
user's program is other than /bin/sh, then .profile is invoked with an argO of -program by both 
login{l) and su(l). 

The - option always resets $PATH to /bin:/etc:/usr/bin for the super-user, and 
/bin:/usr/bin for all others. However, the files /etc/profile and .profile are normally executed 
anyway, thus restoring the intended value of $PATH. 

All attempts to become another user are logged in /usr/adm/sulog, including failures. Successful 
attempts are flagged with "+", failures with "-". 

EXAMPLES 

To become user bin while retaining your previously exported environment, execute: 

su bin 

To become user bin but change the environment to what would be expected if bin had originally 
logged in, execute: 

su - bin 

To execute command with the temporary environment and permissions of user bin, type: 

su - bin -c "command args" 

FILES 

$HOME/. profile user's profile 
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/etc/logingroup 
/etc/passwd 
/etc/profile 
/usr/adm/sulog 



system's default group access list file 
system's password file 
system's profile 
log of all attempts 



VARIABLES 

HOME 



LOGNAME 
PATH 
PSl 
SHELL 



the user's home directory 

the user's login name 

the command name search path 

the default prompt 

the name of the user's shell 



SEE ALSO 

env(l), login(l), sh(l), initgroups(3C), group(4), passwd(4), profile(4), environ(5). 
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NAME 

sum - print checksum and block count of a file 

SYNOPSIS 

sum [ -r ] [ file ] 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also prints the niunber of 
blocks in the file. Stdin is used if no file names are given. Sum is typically used to look for bad 
spots, or to validate a file communicated over some transmission line. The option -r causes an 
alternate algorithm to be used in computing the checksum. 

DIAGNOSTICS 

"Read error" is indistinguishable from end of file on most devices; check the block coimt. 

SEE ALSO 

wc(l). 
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NAME 

tabs - set tabs on a terminal 

SYNOPSIS 

tabs [ tabspec ] [ +mn ] [ -Ttype ] 

DESCRIPTION 

Tabs sets the tab stops on the user's terminal according to the tab specification tabspec, after 
clearing any previous settings. The user's terminal must have remotely-settable hardware tabs. 

If you are using a non-HP terminal, you should keep in mind that behavior will vary for some tab 
settings. 

Four types of tab specification are accepted for tabspec: "carmed," repetitive, arbitrary, and file. 
If no tabspec is given, the default value is -8, i.e., HP-UX "stsindard" tabs. The lowest column 
number is 1. Note that for tabs, column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0. 

-code Gives the name of one of a set of "canned" tabs. The legal codes and their 

meanings are as follows: 
-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this 

code, the first typed character corresponds to card column 7, 

one space gets you to column 8, and a tab reaches colmnn 12. 

Files using this tab setup should include a format specification 

as follows: 

<:t-c2 m6 866 d:> 
-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with more tabs 

than -c2. This is the recommended format for COBOL. The 

appropriate format specification is: 
<:t-<:3 m6 866 d:> 
-f 1,7,11,15,19,23 

FORTRAN 
-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 
-a 1,10,55 

SNOBOL 
-u 1,12,20,44 

UNIVAC 1100 Assembler 

In addition to these "canned" formats, three other types exist: 

-n A repetitive specification requests tabs at columns l+n, l-|-2*n, etc. Of particular 

importance is the value -8: this represents the HP-UX "standard" tab setting, and is the 
most likely tab setting to be found at a terminal. It is required for use with the nroff{l) 
-h option for high-speed output. Another special case is the value -0, implying no tabs 
at all. 



nl,n2,. 



The arbitrary format permits the user to type any chosen set of numbers, separated by 
conunas, in ascending order. Up to 40 numbers are allowed. If any ntunber (except the 
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adeu to the pieVl- 

ous value. Thus, the tab Usts 1,10,20,30 and 1,10,+10,+10 are considered identical. 
— file If the name of a file is given, tabs reads the first Hne of the file, searching for a format 
specification. If it finds one there, it sets the tab stops according to it, otherwise it sets 
them as —8. This type of specification may be used to make sure that a tabbed file is 
printed with correct tab setting, and would be used with the pr(l) command: 
tabs — file; pr file 

Any of the following may be used also; if a given flag occm-s more than once, the last value given 
takes effect: 

-Ttype Tabs usually needs to know the type of terminal in order to set tabs and always 

needs to know the type to set margins. Type is a name Hsted in term (5). If no 
-T flag is supplied, tabs searches for the $TERM value in the environment (see 
environ{5)). If no type can be found, tabs tries a sequence that will work for 
many terminals. 

+mn The margin argument may be used for some terminals. It causes all tabs to be 

moved over n colimms by making column n+1 the left margin. If -|-m is given 
without a value of n, the value asstuned is 10. The normal (leftmost) margin on 
most terminals is obtained by -|-niO. The margin for most terminals is reset only 
when the +in flag is given explicitly. 

Tab and margin setting is performed via the standard output. 

DIAGNOSTICS 

illegal tabs when arbitrary tabs are ordered incorrectly. 

illegal increment when a zero or missing increment is found in an arbitrary specification. 

unknown tab code when a "canned" code cannot be foimd. 

can 't open if — file option used, eind file can't be opened. 

file indirection if — file option used and the specification in that file points to yet another 
file. Indirection of this form is not permitted. 

SEE ALSO 

nroff(l), pr(l), tset(l), environ(5), term(5). 

BUGS 

There is no consistency among different terminals regarding ways of clearing tabs and setting the 

left margin. 

It is generally impossible to usefully change the left margin without also setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), but is willing to set 64. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 



Hewlett-Packard Company - 2 - Version B.l, October 1986 



TAIL(l) HP-UX TAIL(l) 



NAME 

tail - deliver the last part of a file 

SYNOPSIS 

tail [ ±[number][lbc[f] ] ] [ file ] 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a designated place. If no file is 
named, the standard input is used. 

Copying begins at distance +number fi-om the beginning, or -number from the end of the input 
(if number is null, the value -10 is assumed). Number is counted in imits of lines, blocks, or char- 
acters, according to the appended option 1, b, or c. When no units are specified, counting is by 
lines. 

With the -f ("follow") option, if the input file is not a pipe, the program will not terminate after 
the line of the input file has been copied, but will enter an endless loop, wherein it sleeps for a 
second and then attempts to read and copy further records from the input file. Thus it may be 
used to monitor the growth of a file that is being written by some other process. 

EXAMPLES 

Tail accepts at most two arguments: the first consists of specified options, and the second specifies 
the file of interest. If the number and f options are both desired, they must be concatenated to 
create a single option argmnent, as shown in this example: 

tail -31f John 

This example prints the last three lines in the file John to the standard output, and leaves tail in 
"follow" mode. 

If only the f option is desired, it must be preceded by a -, as follows: 
tail -f fred 

This example prints the last ten lines of the file fred, followed by any lines that are appended to 
fred between the time tail is initiated and killed. Note that this output may build up very 
quickly for rapidly changing input files, perhaps too fast to read on a CRT. 

As another example, the command: 
tail -15cf fred 

will print the last 15 characters of the file fred, followed by any lines that are appended to fred 
between the time tail is initiated and killed. 

The -I- option starts at the nmnber indicated from the beginning of the file (rather than skipping 
the number of units indicated and then starting.) For example: 
tail +lb fred 

prints the entire contents of the file fred. 

SEE ALSO 

dd(l), head(l). 

BUGS 

Tails relative to the end of the file are stored in a buffer, and thus are limited in length. Thus, be 
wary of the results when piping output from other commands into tail. 

Various kinds of anomalous behavior may happen with character special files. 

Tail can pick up a maximmn of 4K bytes of data from the specified file. 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

tar - tape file archiver 

SYNOPSIS 

tar [key] [ [ file I -C directory ] ... ] 

DESCRIPTION 

Tar saves and restores files on magnetic tape or flexible disk. Its actions are controlled by the key 
argument. The key is a string of characters containing at most one function letter and possibly 
one or more function modifiers. The key string may be preceded by a dash (-) (similar to the way 
options are specified in other HP-UX commands), but it is not necessary. Other arguments to the 
conunand are files (or directory names) specifying which files are to be dumped or restored. In all 
cases, appearance of a directory name refers to the files and (recursively) subdirectories of that 
directory. 

The function portion of the key is specified by one of the following letters: 

r The named files are added to the end of the archive. The c function implies this func- 

tion. 
X The named files are extracted from the archive. If a named file matches a directory 

whose contents had been written onto the archive, this directory is (recursively) 
extracted. If a named file on tape does not exist on the system, the file is created as fol- 
lows: 

The user, group, and other protections are restored from the tape. 
The modification time is restored from the tape imless the m option is specified. 
The file owner and group owner are normally that of the restoring process. 
The set-user-ID, set-group-ID and sticky bits are normally not set. The o and p 
options control the restoration of protection; see below for more details. 
If the files exist, their modes are not changed except that the set-user-ID, set-group-ID 
and sticky bits are cleared. If no files argument is ^ven, the entire content of the 
archive is extracted. Note that if several files with the same name are on the archive, 
the last one overwrites all earlier ones. 
t The names of all the files on the archive are listed. Adding the v option will expand this 

listing to include the file modes and owner niunbers. The names of all files are listed 
each time that they occur on the tape. 
u The named files are added to the archive if they are not already there, or have been 

modified since last written on that archive. 
c Create a new archive; writing begins at the begiiming of the archive, instead of after the 

last file. This command implies the r function. 

The following function modifiers may be used in addition to the function letters listed above: 

#8 Where # is a tape drive number (0,...j7), and s is the density (1 - low (800 bpi), m - 

medium (1600 bpi), or h - high (6250 bpi)). This modifier selects the drive on which the 
9 track tape is mounted. The default is Om. 

V Normally, tar does its work silently. The v (verbose) option causes it to type the name 

of each file it treats, preceded by the function letter. With the t function, v gives more 
information about the tape entries than just the name. 

w Causes tar to print the action to be taken, followed by the name of the file, and then 

wait for the user's confirmation. If a word beginning with y is given, the action is per- 
formed. Any other input means "no". 

f Caiises tar to use the next argument as the name of the archive instead of 

/dev/rmt/Om. If the name of the file is -, tar writes to the standard output or reads 
from the standard input, whichever is appropriate, and the default blocking factor 
becomes 1. Thus, tar can be used as the head or tail of a pipeline. Tar can also be used 
to move hierarchies with the command: 
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cd fromdir; tar cf - . | (cd todir; tar xf -) 

b Causes tar to use the next argument as the blocking factor for archive records. If both f 

and b modifiers are specified, their arguments m\ist match the order in which they are 
specified. The default is 20; the maximmn is at least 20. However, if the f - modifier is 
used, the default blocking factor is 1. The block size is determined automatically when 
reading 9 track tapes (key letters x and t). The blocking factor must be specified when 
reading flexible disks and cartridge tapes if they were written with a blocking factor 
different than the default. 

1 Tells tar to complain if it cannot resolve all of the links to the files being dumped. If 1 is 

not specified, no error messages are printed. 

m Tells tar to not restore the modification time written on the archive. The modification 

time of the file will be the time of extraction. 

o For writing: 

This option suppresses writing certain directory information that older versions of tar 
cannot handle on input. Tar normally writes information specifying owners and modes 
of directories in the archive. Former versions of tar, when encountering this information, 
will give error message of the form 

"<name>/: cannot create". 
This option will suppress writing that information. 

For reading: 

Causes extracted files to take on the user and group identifier of the user running the 
program rather than those on the tape. This is the default for the ordinary user, and 
may be overridden, to the extent the system protections allow, by the p option. 
p This option causes files to be restored to the original modes and ownerships written on 

the archive, if possible. This is the default for the super-user, and may be overridden by 
the o option. For the ordin£iry user, if the system protections forbid the chown{2) opera- 
tion needed to do this, the error will be ignored, and the ownership left with the restor- 
ing process. Set-user-ID, set-group-ID and sticky information will be restored as allowed 
by the protections defined by chmod{2), if the chown operation above succeeded. 

The following option may be included in the file list: 

-Cdirectory tar will perform a chdir{2) to directory. This allows multiple directories not 
related by a close common parent to be archived using short relative path names. 

If a 9 track tape drive is used as the output device, it must be configured in Berkeley compatibil- 
ity mode; see mt{7). 

EXAMPLES 

tar cvf /dev/rfd.O filel file2 

This example creates a new archive on /dev/rfd.O and copies filel and file2 onto it, using a block- 
ing factor of 20. The key is made up of one function letter (c) and two function modifiers (v, and 

r). 

tar cv -C /usr include -C / etc 
This example archives files from /usr/include and from /etc. 

ERRORS 

Tar complains about bad key characters and tape read/write errors. 

Tar complains if enough memory is not available to hold the link tables. 

WARNINGS 

There is no way to ask for the n-th occurrence of a file. 
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Tape errors are handled ungracefully. 

The u option can be slow. 

If the archive is on a flexible disk or cartridge tape, and if the blocking factor specified on output 
was not the default, the same blocking factor must be specified on input. This is because the 
blocking factor is not explicitly stored on the archive. Not following this rule and updating the 
archive can destroy it. 

The current limit on filename length is 100 characters. 

Some previous versions of tar have claimed to support selective listing of file names using the t 
option with a list. To our knowledge this was an error in the docmnentation and does not appear 
in the original source code. 

There is no way to restore an absolute path name to a relative position. 

Tar always pads information written to an archive up to the next multiple of the block size. 
Therefore, if you are creating a small archive and write out one block of information, tar reports 
that one block was written, but the actual size of the archive may be larger if the b option was 
used. 

Note that tar cOm is not the same as tar cmO. 

Archives should never be created on block special devices. 

AUTHOR 

Tar was developed by AT&T and the University of Ceilifomia, Berkeley. 

FILES 

/dev/rmt/* 

/dev/rfd.* 

/tmp/tar* 

SEE ALSO 

ar(l), cpio(l), mt(7). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NANfE 

tbl - format tables for nroff 

SYNOPSIS 

tbl [ -TX 1 [ files 1 

DESCRIPTION 

Tbl is a preprocessor that formats tables for nroff{l). The input files are copied to the standard 
output, except for lines between .TS and .TE command lines, which are assumed to describe 
tables and are re-formatted by tbl. (The .TS and .TE command lines are not altered by tbl). 

.TS is followed by global options. The available global options are: 

center center the table (default is left-adjust); 

expand make the table as wide as the current line length; 

box enclose the table in a box; 

doublebox 

enclose the table in a double box; 
allbox enclose each item of the table in a box; 
tab (i) use the character x instead of a tab to separate items in a line of input data. 

The global options, if any, are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each such format line describes 
one line of the actual table, except that the last format line (which must end with a period) 
describes all remaining lines of the table. Each colmnn of each line of the table is described by a 
single key-letter, optionally followed by specifiers that determine the font and point size of the 
corresponding item, that indicate where vertical bars are to appear between colmnns, that deter- 
mine column width, inter-colimm spacing, etc. The available key-letters are: 

c center item within the column; 

r right-adjust item within the colimm; 

1 left-adjust item within the coIimm; 

n niimerically adjust item in the column: imits positions of numbers are aligned 

vertically; 
s span previous item on the left into this colmnn; 

a center longest line in this colunm and then left-sidjust all other lines in this 

column with respect to that centered line; 

span down previous entry in this colmnn; 
_ replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; the character | indicates a 
vertical line between columns. 

The format lines are followed by lines containing the actual data for the table, followed finally by 
.TE. Within such data lines, data items are normally separated by tab characters. 

If a data Ime consists of only or =, a single or double line, respectively, is drawn across the 

table at that point; if a single item in a data line consists of only _ or =, then that item is 
replaced by a single or double line. 

Full details of these and other featiu-es of tbl are given in the tbl reference guide. 

The -TX option forces tbl to use only full vertical line motions, making the output more suitable 
for devices that cannot generate partial vertical line motions (e.g., line printers). 

If no file names are given as argmnents (or if - is specified as the last argument), tbl reads the 
stamdard input, so it may be used as a filter. When it is used with negn(l), neqn, tbl should come 
first to minimize the volume of data passed through pipes. 
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EXAMPLE 

If we let <tab> represent a tab (which should be typed as a genuine tab), then the input: 

.TS 

center box ; 
cB 8 s 
cl ] cl s 
^ I c c 
1 I n n . 
Household Population 

Town<tab>Households 
<tab>Nimiber<teb>Size 

Bedminster<tab>789<tab>3.26 
Bernards Twp.<tab>3087<tab>3.74 
Bemardsville<tab>2018<tab>3.30 
Bound Brook<tab>3425<tab>3.04 
Bridgewater<tab>7897<tab>3.81 
Far Hills<tab>240<tab>3.19 
.TE 

yields: 



Household Population I 


Town 


Households 


Number Size 


Bedminster 


789 3.26 


Bernards Twp. 


3087 3.74 


Bemardsville 


2018 3.30 


Boimd Brook 


3425 3.04 


Bridgewater 


7897 3.81 


Far Hills 


240 3.19 



SEE ALSO 

cw(l), mm(l), neqn(l), nroff(l), mm(4). 

BUGS 

See BUGS under nroff(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

tcio - Command Set 80 Cartridge Tape Utility 

SYNOPSIS 

tcio -ofdervVZ] [ -S buffersize ] [ -1 number [ -n limit ] ] filename 
tcio -i[drvZ] [ -S buffersize ] [ -1 munber [ -n limit ] ] filename 
tcio -u[rvV] [ -m blocknmnber ] [ -1 number ] filename 

DESCRIPTION 

Tcio is designed to optimize the data transfer rate between certain cartridge tape units and the 
host processor. When used in conjimction with other utilities (such as cpto(l)) a significant 
improvement in throughput can be obtained, in addition to reducing the wear and tear on the 
tape cartridges and drives. With autochanger mechanisms, tcio provides the capability of loading 
a specified cartridge, or automatic£illy switching to successive cartridges as needed. With the util- 
ity operation, tcio provides functions that are imique to cartridge tapes. 

Tcio -o (copy out) reads the standard input and writes the data to the Command Set 80 Car- 
tridge Tape Unit specified by filename. 

Tcio -i (copy in) reads the Command Set 80 Cartridge Tape Unit specified by filename £ind writes 
the data to the standard output. 

Tcio -u (utility) performs utility functions on the cartridge tape, such as imload, msirk, and/or 
verify the cartridge. 

In all cases, filename must refer to a character special file associated with a Command Set 80 car- 
tridge tape imit. 

With the output and input operations, tcio enables immediate report mode on cartridge tape units 
that support this mode (see HARDWARE DEPENDENCIES). During writing, this mode enables 
the drive to complete a write transaction with the host before the data has actually been written 
to the tape from the drive's buffer. This allows the host to start gathering data for the next write 
request while the data for the previous request is still in the process of being written. During 
reading, this mode enables the drive to read ahead after completing a host read request. This 
allows the drive to gather data for futm-e read requests while the host is still processing data from 
the previous read request. Under favorable conditions, immediate report mode allows the drive to 
stream the tape continuously across multiple read/write requests, £is opposed to having to reposi- 
tion the tape between each read/write request. See ct(7) for further details. 

By default, tcio puts a tape mark in the first block on each tape to prevent the tape from being 
image restored over a disk. It eiIso utilizes the last block on each tape to fiag whether or not the 
tape is the last tape in a multi-tape sequence. 

The following command options are recognized. One of the options -o, -i, or -u must be 
specified. Additional options can be specified in any order, but all must precede the file name. 
Options without parameters Ccm be listed individually or grouped together. Options with parame- 
ters require the parameter and must be listed individually. The meanings of the available 
modifiers are: 

—V Verbose mode; prints information and error messages to stderr. 

-d Prints a checksmn to stderr. The checksum is a 32-bit unsigned addition of the 

bytes that provides an extra check of the validity of the tape (in addition to tape 
verification.) The value is only reported to the user and is not written on the 
media. Thus, the user must memually record £ind check it. The checksmn is 
valid only if the same number of bytes are read from the tape as were written to 
it. This option is independent of the verbose modifier. 

-e Causes a tape mark to be written on the nearest 1024-byte boimdary following 

the end of the data. When a tape containing an end-of-data tape mark is read 
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back, the read will terminate upon encountering the tape mark. Thus, with the 
use of this option, the checksums generated by the input and output operations 
are guarsmteed to agree. 

-V This option turns off tape verification. Some cartridge tape imits (see 

HARDWARE DEPENDENCIES) provide hardware for verifying the data out- 
put to the tape (called read- while- write). For these imits software-driven 
verification is redundant, and this option is suggested. 

For those drives that do not have the read-while-write hardware, a separate 
verification operation is suggested. Thus, it is recommended that this option not 
be used with drives that do not support read-while-write. 

-r Unloads the tape from the drive. On autochanger imits, the tape is returned to 

the magazine. 

-S buffersize Enables specification of buffer size. This option forces the allocation of a block of 
memory to be used in reading or writing the tape. The size in bytes of the buffer 
is 1024 times the v£ilue specified for buffersize. A buffersize less thjin 4 will be 
silently increased to 4; a buffersize greater than 64 will be silently decreased to 
64. If buffersize is not specified, tcio will allocate a 64 Kbyte buffer. 

On tape units that support immediate report, a significant preformance increase 
can often be obtained by using a smaller buffer ~ 8 Kbytes is the recommended 
buffer size for these units. On tape units that do not support the immediate 
report mode, or on tape units that are on a shared controller with a disk (see 
HARDWARE DEPENDENCIES) that is simultaneously bemg accessed, an 
increase in performance can usually be obtained with a larger buffer ~ 64 Kbytes, 
the default, is the recommended buffer size for these xmits. 

-m blocknumber 

This option writes a tape mark on a tape at the specified block. A tape mark in 
block zero of the tape will prevent it from being image restored to a disk. 

-Z This option prevents tcio from writing a file mark in the first and last blocks. 

This option should be used with care, as a tape without a tape mark in block 
zero can be image restored to a disk. 

-1 number This option is intended solely for autochanger-type tape units. With the input 

or output operations ( -i or -o ) the autochanger option selects the cartridge 
from the magazine with which the transfer will begin. When used with the util- 
ity function (-u option), tcio will load the specified cartridge into the drive. 
(Note: the autochanger must be in selective mode for the autochanger options to 
work properly.) 

-n limit This option specifies the maximmn number of cartridges to be used in a multi- 

tape transfer. It applies only to autochsmger type imits, and must be preceded 
by the -1 option. Thus, -1 starts the transfer by loading cartridge number and 
will use at most limit cartridges. If -1 is specified without -n, tcio quietly 
assiunes the remaining cartridges (in ascending order) from the magsizme. 

EXAMPLES 

The first example below copies the contents of a directory into an archive; the second restores it: 

Is I cpio -o I tcio -o /dev/rct/cOdl 
tcio -i /dev/rct/cOdl I cpio -i 
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To unload the cartridge from the drive (without verifying the tape) execute: 

tcio -urV /dev/rct/cOdl 

The next example copies all files in the current directory to the tape specified by the device file 
/dev/rct/cldOB2. The device has a read-while-write head, so verify is turned oflF; a buflfer size 
(option -S) of 8 blocks (i.e. 8 Kbytes) is specified: 

Is I cpio -o I tcio -oV -S 8 /dev/rct/cld082 

The next example assmnes that the cartridge tai>e imit is an autochanger, on controller 2, with 8 
tapes in the magazine. The tcio operation will start writing with cartridge 3, and will use at most 
4 cartridges before prompting the user for additional media: 

find usr -cpio I tcio -oV -S 8 -1 3 -n 4 /dev/rct/c2 

HARDWARE DEPENDENCIES 

HP7941CT, HP9144A, and HP35401 

These cartridge tape devices support the immediate report mode. 

HP7942, HP7946 

These cartridge tape devices support the immediate report mode. The use of a small bufiFer 
size is not recommended with these shared controller devices when there is simultaneous 
access to the disk, because the disk accesses will prevent proper tape streaming. 

HP7908, HP7911, HP7912, and HP7914 

These cartridge tape devices do not support the immediate report mode. 

AUTHOR 

Tcio was developed by HP. 

SEE ALSO 

ct(7). 

HP-UX System Administrator Manual. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

tcio - Command Set 80 Cartridge Tape Utility 

SYNOPSIS 

/etc/tcio -o [ dervSVC ] [ bufiFersize ] filename 

/etc/tcio -i [ drvS ] [ buffersize ] filename 

/etc/tcio -u [ cmrvV ] [ blocknimiber ] [ save I restore ] filename [ disc filename ] 

Remarics: 

This manual page describes the Series 500 implementation only. See other manual page for Series 
200/300 implementation. Not supported on the Integral Personal Computer. 

DESCRIPTION 

Tcio -0 (copy out) reads the standard input and writes the data to the raw Command Set 80 
Cartridge Tape Unit specified by filename. 

Tcio -i (copy in) reads the Command Set 80 Cartridge Tape Unit specified by filename in raw 
mode and writes the data to the standard output. 

Tcio -« (utility) performs utility functions on the cartridge tape, such as image backup and 
restore, release, mark, and/or verify cartridge. 

In all cases, filename MUST refer to a character special file associated with a Command Set 80 
cartridge tape imit. 

With the output and input operations, tcio utilizes a large buffer to transfer data to/from the car- 
tridge tape, yielding a significant increase in performance, as well as a savings in wear and tear on 
the media and the mechanism. In addition, tcio puts a tape mark in the first block on each tape 
to prevent the tape from being image restored over a disc; it also utilizes the last block on each 
tape to flag whether the tape is the last tape in a multi-tape sequence or not. 

With the utility operation, tcio provides functions that are unique to cartridge tapes. 

One of the options o, i, or u must be specified. The meanings of the available modifiers are: 

V Verbose mode; prints information and error messages to atderr. 

d Prints a checksxmi to atderr. The checksum is a 32-bit unsigned addition of the bytes, pro- 
viding an extra check of the validity of the tape in addition to tape verification. The value is 
only reported to the user and is not written on the media; thus, it's left up to the user to 
manually record and check it. The checksimi is valid only for the i and o operations, and if 
the same number of b3rtes are read from the tape as were written to it. This option is 
independent of the verbose modifier. 

e Apphes only to the output operation, and causes a tape mark to be written on the nearest 
1024-byte boundary following the end of the data. When a tape containing an end-of-data 
tape mark is read back, the read will terminate upon encountering the tape mark. Thus, 
with the use of this option, the checksmns generated by the input and output operations are 
guaranteed to agree. 

S Enables specification of buffer size. This option forces the allocation of a block of memory to 
be used in reading or writing the tape. The size in bytes of the buffer is 1024 times the value 
specified for buffersize. A buffersize less than 32 or greater than 512 will cause the program 
to terminate. If buffersize is not specified, tcio will attempt to allocate buffer sizes in powers 
of 2 from 512 down to 64, taking the largest one possible. The primary uses of this option 
are to allow buffer sizes smaller than 64 Kbytes, and to allow the user to pick a buffer size 
that is most suitable for his application. 

V This option turns off tape verification. It is suggested that this option not be used, for the 



sake of the integrity of the data output to tape. 
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m This option writes a tape mark on a tape at the specified block. If a tape is created by some 
other means than tcio, a tape mark in block of the tape will prevent it from being image 
restored to a disc. Note that blocknumber must be specified. 

r Releases the tape from the mechanism, imlocking the door. 

c Image copy option. Provides the same capability as the push-button save and restore avail- 
able in the HP 79XX single controller drive. The save and restore keywords are the s£ime 
as the labels on those switches. Save implies disc to tape; restore implies tape to disc. 
Ciurrently only single controller disc/tape imits can be backed up in this way. 

C Check read option. Provides a measure of data security not foimd in the tape verification or 
check digit options. Check read requires two I/O buffers of the size indicated by buffersize, 
one for writing and one for reading. The data in the first buffer is written to the tape. Then 
the tape is backspaced «md read into the second buffer. The two buffers are then compared. 
If a difference occurs, tcio reports the error and terminates. This option forces no tape 
verification. Note that this option promotes wear and tear on both the media and the drive, 
and should only be used when complete £issurance of the data's integrity is required. 

HARDWARE DEPENDENCIES 

In general, tapes which have emy tape marks other than in the first or the last block ceuinot be 
read successfully. 

The e option is not supported, and because of the above restriction, tapes which have been writ- 
ten imder the e option cannot be read successfully. 

EXAMPLES 

The first example below copies the contents of a directory into an archive; the second restores it: 

Is I cpio -o I tcio -o /dev/rct 

tcio -i /dev/rct I cpio -i 

The next example copies all files in the current directory (via executing find) to the tape specified 
by the device file /dev/rct; a checksum (option -d) is performed to verify that the write to tape 
was performed correctly; verbose mode (-v) is used so that you can see the file names of files being 
copied; in addition, a buffer size (option -S) is specified at 128 memory blocks: 

find . -print I cpio -o I tcio -odvS 128 /dev/rct 

The following example copies all the files and directories from the tape (specified by /dev/rct) to 
the cvurent directory; the data is transfered through a 128-block buffer. Note that with the cpio 
command, the wildcard character * is inclosed in double quotes "*"; this must be done so that the 
shell doesn't expand the * to all the files in the current directory— i.e., you want the * to be inter- 
preted as all the files on the tape, not your ctirrent directory. Here is the command: 

tcio -ivS 128 /dev/rct I cpio -icdvu "*" 

SEE ALSO 

cpio(l). 

WARNING 

To be able to use the save/restore facility, the following two conditions must be met: 

your system must be in single-user mode; 

you must never have used networking on yoiu* system. If networking has been used on 
your system, you must reboot the system before using the save/restore facility. 

Tcio can tie up substantial portions of memory, creating a situation where progress on other 
processes (including those processes feeding tcio) is hindered. If this should occur, it is best to kill 
tcio and re-execute using a smaller buffersize. This problem is especially acute when using the C 
option, because two buffers are required. 
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BUGS 

If the cartridge drive cannot read the manufacturer's block on the tape, the cartridge is locked in 
the drive and c£innot be extracted without turning off the disc/tape drive. This failure is usually 
the result of faulty tapes or a dirty drive mechanism. 
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NAME 

tee - pipe fitting 

SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

Tee transcribes the standard input to the standard output and makes copies in the files. The -i 
option ignores interrupts; the -a option causes the output to be appended to the files rather than 
overwriting them. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

test - condition evaluation command 

SYNOPSIS 

test expr 
[ expr ] 

DESCRIPTION 

Test evaluates the expression expr and, if its value is true, returns a zero (true) exit status; other- 
wise, a non-zero (false) exit status is returned; test also retiums a non-zero exit status if there are 
no arguments. The following primitives are used to construct expr: 

-r file true if file exists and is readable. 

-w file true if file exists and is writable. 

true if file exists and is executable. 

true if file exists and is a regular file. 

true if file exists and is a directory. 

true if file exists and is a character special file. 

true if file exists and is a block special file. 

true it file exists and is a named pipe (fifo). 

true if file exists and its set-user-ID bit is set. 

true if file exists and its set-group-ID bit is set. 

true if file exists and its sticky bit is set. 

true if file exists and has a size greater than zero. 

true if the open file whose file descriptor number is fUdes (1 by default) is associated 
with a terminal device. 

true if the length of string si is zero. 

true if the length of the string si is non-zero. 

true if strings si and sS are identical. 

true if strings si and s8 are not identical. 

true if si is not the null string. 

true if the integers nl and nS are algebraically equal. Any of the comparisons -ne, 
-gt, -ge, -It, and -le may be used in place of -eq. 

These primaries may be combined with the following operators: 

! imary negation operator. 

-a binary and operator. 

-o binary or operator (-a has higher precedence than -o). 

( expr ) parentheses for grouping. 

Notice that all the operators and flags are separate arguments to test. Notice also that 
parentheses are meaningful to the shell and, therefore, must be escaped. 



-X file 


-{file 


-d file 


-c file 


-h file 


-P file 


-u file 


-gfile 


-k file 


-s file 


-t [ fildes ] 


-z si 


-n si 


si = s8 


si \= s2 


si 


nl -eq n8 
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Test is directly interpreted by the shell. 

WARNINGS 

In the second form of the command (i.e., the one that uses (], rather than the word test), the 
square brackets must be delimited by blanks. 

SEE ALSO 

find(l), sh(l). 
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NAME 








time - 


- time 


a command 


SYNOPSIS 








time 


command 





DESCRIPTION 

The command is executed; after it is complete, time prints the elapsed time dmring the command, 
the time spent in the system, and the time spent in execution of the command. Times are 
reported in seconds. 

The execution time can depend on the performance of the memory in which the program is nm- 
ning. 

The times are printed on standard error. 

HARDWARE DEPENDENCIES 

Series 500: 

For those computers with multiple CPU's, the child CPU times listed may be greater 
than the actual real elapsed time, since CPU time is counted on a per-CPU basis. Thus, 
if three CPUs £ire executing, the times listed are obtained by adding the execution times 
of each CPU. 

SEE ALSO 

times command in sh(l), timex(l), times(2). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

touch - update access, modification, and/or change times of file 

SYNOPSIS 

touch [ -amc ] [ mmddhhnmi[jry] ] files 

DESCRIPTION 

Touch causes the access, modification, and last change times of each argument to be updated. 
The file name is created if it does not exist. If no time is specified (see date{l)) the current time 
is used. The —a and -m options cause touch to update only the siccess or modification times 
respectively (default is -am). The -c option silently prevents touch from creating the file if it did 
not previously exist. 

The retmn code from touch is the number of files for which the times could not be successfully 
modified (including files that did not exist and were not created). 

SEE ALSO 

date(l), utune(2). 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

tput - query terminfo database 

SYNOPSIS 

tput [ -T type ] capname 

DESCRIPTION 

Tput uses the terminfo (4) database to make terminal-dependent capabilities and information 
available to the shell. Tput outputs a string if the attribute (capabihty name) is of type string, 
or an integer if the attribute is of type integer. If the attribute is of type boolean, tput simply 
sets the exit code (0 for TRUE, 1 for FALSE), and does no output. 

-Ttype indicates the tjrpe of terminal. Normally this flag is mmecessary, as the default 

is taken from the environment variable STERM. 

Capname indicates the attribute from the terminfo database. See terminfo (4). 

EXAMPLES 

tput clear Ek;ho clear-screen sequence for the current terminal. 

tput cols Print the niunber of colimms for the current terminal. 

tput -Thp2623 cols 

Print the ntunber of columns for the hp2623 terminal. 

bold='tput smso' 

Set shell variable "bold" to stand-out mode sequence for current terminal. This 

might be followed by a prompt: 

echo "${bold}Please type in your name: \c" 

tput he Set exit code to indicate if current terminal is a hardcopy terminal. 

FILES 

/usr/lib/terminfo/?/* Terminfo data base 
/usr/include/curses.h 
/usr/include/term.h Definition files 

DIAGNOSTICS 

Tput prints error messages and retiuns the following error codes on error: 
-1 Usage error. 
-2 Bad terminal type. 
-3 Bad capname. 

In addition, if a capname is requested for a terminal that has no value for that capname (e.g., 
tput -Thp2623 vt), -I is prmted. 

SEE ALSO 

stty(l), terminfo(4). 
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NAME 

tr - translate characters 

SYNOPSIS 

tr [ -cds ] [ stringl [ string2 ] | 

DESCRIPTION 

Tr copies the standard input to the standard output with substitution or deletion of selected 
characters. Input characters foimd in stringl are mapped into the corresponding characters of 
string2. Any combination of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to the universe of characters 

whose ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in stringl . 

-8 Squeezes all strings of repeated output characters that are in string2 to single characters. 

The following abbreviation conventions may be used to introduce ranges of characters or repeated 
characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run from character a to character 
z, inclusive. 

[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is considered octal; otherwise, 
n is taken to be decimal. A zero or missing n is taken to be huge; this facility is useful 
for padding string2. 

The escap)e character \ may be used as in the shell to remove special meaning from any character 
in a string. In addition, \ followed by 1, 2, or 3 octal digits stands for the character whose ASCII 
code is given by those digits. 

EXAMPLE 

The following creates a list of all the words in filel one per line in fHe2, where a word is taken to 
be a maximal string of alphabetics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline. 

tr -cs "[A-Z][a-z]" "[\012*]" <filel >file2 

SEE ALSO 

ed(l), sh(l), ascii(5). 

BUGS 

Will not handle ASCII NUL in stringl or string2; always deletes NUL from input. 

INTERNATIONAL SUPPORT 

8- and 16-bit data. 
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NAME 

true, false - provide truth values 

SYNOPSIS 
true 

false 

DESCRIPTION 

True does nothing, successfully. False does nothing, unsuccessfully. They are typically used in 
input to sh{l) such as: 

while true 
do 

command 
done 

SEE ALSO 

machid(l), sh(l). 

DIAGNOSTICS 

True has exit status zero, false nonzero. 



Hewlett-Packard Company - 1 - Version B.l, October 1986 



TSET(l) HP-UX TSET(l) 



NAME 

tset - terminal dependent initialization 

SYNOPSIS 

tset [ options ] [ -m [ ident ) ( test baudrate ] :type ] ... [ type ] 

reset ... 

DESCRIPTION 

Taet sets up your terminal when you first log in to an HP-UX system. It does terminal dependent 
processing, such as setting erase and kill characters, setting or resetting delays, and sending any 
sequences needed to properly initialize the terminal. It first determines the type of terminal 
involved, and then does the necessary initializations and mode settings. The type of terminal 
attached to each HP-UX port is specified in the /etc/ttytype data base. Type names for terminals 
may be foimd in the files imder the /usr/lib/terminfo directory (see terminfo{A)). If a port is not 
wired permanently to a specific terminal (not hardwired), it will be given an appropriate generic 
identifier, such as dialup. 

In the case where no argmnents are specified, taet simply reads the terminal tjrpe out of the 
environment variable TERM and re-initializes the terminal. The rest of this manual entry con- 
cerns itself with mode and environment initialization, typically done once at login, and options 
used at initialization time to determine the terminal type and set up terminal modes. 

When used in a startup script {.profile for sh{l) users, or .login for csh{l) users) it is desirable to 
give information about the tyi)e of terminal you will usually use on ports which £ire not hardwired. 
These ports are identified in /etc/ttytype as dialup or plugboard, etc. To specify what terminal 
type you usually use on these ports, the -m (map) option flag is followed by the appropriate port 
type identifier, an optional baud rate specification, and the terminal type. (The effect is to "map" 
from some conditions to a terminal type, that is, to tell tset, "If I'm on this kind of port, then I'll 
probably be on this kind of terminal".) If more than one mapping is specified, the first applicable 
mapping prevails. A missing port type identifier matches all identifiers. A baudrate is sj)ecified as 
with stty{l), and is compared with the speed of the diagnostic output (which should be the control 
terminal). The baud rate test may be any combination of >, =, <, @ @, and !; is a synonym 
for = and ! inverts the sense of the test. To avoid problems with metacharacters, it is best to 
place the entire argument to -m within single quotes; users of csh{l) must also put a "\" before 
any "!" used. 

Thus, 

tset -m 'dialup>300:2622 ' -m ' dialup: 2624 ' -m 'plugboard:?2623 ' 

causes the terminal type to be set to an HP 2622 if the port in use is a dialup at a speed greater 
than 300 baud, or to an HP 2624 if the port is otherwise a dialup (i.e. at 300 baud or less). If the 
type finally determined by tset begins with a question mark, the user is asked if he or she really 
wants that type. A null response means to use that type; otherwise, another type can be entered. 
Thus, in the above case, if the user is on a plugboard port, he or she will be asked whether or not 
he or she is actually using an HP 2623. 

If no mapping applies and a final type option, not preceded by a — m, is given on the command 
line, then that type is used. Otherwise, the identifier foimd in the /etc/ttytype data base will be 
taken to be the terminal type. The latter should always be the case for hardwired ports. 

It is usually desirable to return the terminal type, as finally determined by tset, and information 
about the terminal's capabilities to a shell's environment. This can be done using the -s option. 
Using the Bourne shell (s/i(l)), the command 

eval 'tset -s options...^ 

or using the C shell, csh{l): 
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set noglob; eval Hset -s options... 

These commands cause tset to generate as output a sequence of shell commands which place the 
variable TERM in the environment; see environ (5). 

Once the terminal type is known, tset engages in terminal mode setting. This normally involves 
sending an initialization sequence to the terminal, setting the single character erase (and option- 
ally the full line erase or line-kill) characters, and setting special character delays. Tab and new- 
line expansion are turned off during transmission of the terminal initialization sequence. 

On terminals that can backspace but not overstrike (such as a CRT), and when the erase charac- 
ter is the default erase character ("#" on standard systems), the erase character is changed to 
BACKSPACE (*H). 

The options are: 

-ec sets the erase character to be the named character c; c defaults to *H (BACKSPACE). 
The character c can either be typed directly, or entered using the "hat" notation used 
here (e.g. the "hat" notation for control-H is *H; in sh{l), the * character should be 
escap>ed (\*)). 

-kc sets the kill character to c. The default c is *X. If c is not specified, the kill character 
will remain imchanged imless the original value of the kill character is null. In this ceise, 
the kill character is set to an "at" sign (@). 

- report terminal type. Whatever type is decided on is reported. If no other flags are 

given, the only effect is to write the terminal type on the standard output. 

-8 generates appropriate commands (depending on your SHELL environment variable) to set 

TERM. 

-I suppresses transmitting terminal initialization strings. 

-Q suppresses printing the "Erase set to" and "Kill set to" messages. 

-A asks the user for the TERM type. 

-S Outputs the strings that would be assigned to TERM in the environment rather than 
generating commands for a shell. In sh{l), the following is an alternate way of setting 
TERM. 

set ~ "tset -S ..." 
TERM=$1 

-h forces a read of /etc/ttytype. When -h is not specified, the terminal type is determined 

by reading the environment, unless some mapping is specified. 

For compatibility with earlier versions of taet, the following flags are accepted, but their use is 
discouraged: 

-r report to the user in addition to other flags. 

-Ec sets the erase character to c only if the terminal can backspace. C defaults to *H. 

EXAMPLES 

These examples all assmne the Bourne shell (5/1(1)). Note that a typical use of tset in a .profile 
will also use the -e and -k options, and often the -n or -Q options as well. These options have 
not been included here to keep the examples small. 

Assume, for the moment, that you are on an HP 2622. This is suitable for typing by hand but 
not for a .profile, miless you are always on a 2622. 

export TERM; TERM="tset - 2622" 
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Now, you have an HP 2623 at home which you dial up on, but your office terminal is hardwired 
and known in /etc/ttytype. 

export TERM; TERM=Hset - -m dialup:2623^ 

You have a switch which connects everything to everything, making it nearly impossible to key on 
what port you are coming in on. You use an HP 2622 in your office at 9600 baud, and dial up to 
switch ports at 1200 baud from home on an HP 2623. Sometimes you use someone else's terminal 
at work, so you want it to ask you to make sure what terminal type you have at high speeds, but 
at 1200 baud you are eilways on a 2623. Note the placement of the question mark, and the quotes 
to protect the > and ? from interpretation by the shell. 

export TERM; TERM=nset - -m 'switch> 1200:72622' -m 'switch<=1200:2623'' 

All of the above entries will fall back on the terminal type specified in /etc/ttytype if none of the 
conditions hold. The following entry is appropriate if you always dial up, always at the same 
baud rate, on many different kinds of terminals. Your most common terminal is an HP 2622. It 
always asks you what kind of terminal you are on, defaulting to 2622. 

export TERM; TERM=Hset - 72622^ 

If the file /etc/ttytype is not properly installed and you want to key entirely on the baud rate, the 
following can be used: 

export TERM; TERM=Hset - -m '>1200:2624' 2622^ 

FILES 

/etc/ttytype port name to terminal type mapping data base; 

/usr/lib/terminfo/7/* terminal information data base. 
VARIABLES 

SHELL if "csh" then generate csh{l) commands, otherwise generate ah{l) commands. 
TERM the (canonicEil) terminal name. 

AUTHOR 

Tset was developed by the University of California, Berkeley California, Computer Science Divi- 
sion, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

csh(l), sh(l), stty(l), ttytype(4), environ(5). 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items consistent with a partial 
ordering of items mentioned in the input file. If no file is specified, the standard input is imder- 
stood. 

The input consists of pairs of items (nonempty strmgs) separated by blanks. Pairs of different 
items indicate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l). 

DIAGNOSTICS 

Odd data: there is an odd nmnber of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 

tty - get the name of the terminal 

SYNOPSIS 

tty [ -9 ] 

DESCRIPTION 

Tty prints the path name of the user's terminsil. The -s option inhibits printing of the terminal 
path name, allowing one to test just the exit code. 

RETURN VALUE 

if standard input is a terminal, 

1 otherwise. 

2 if invalid options were specified, 

DIAGNOSTICS 

"not a tty" if the standard input is not a terminal and -8 is not specified. 
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NAME 

tty, pty - get the name of the terminal 

SYNOPSIS 

tty [ -8 ] 

pty [ -8 ] 

DESCRIPTION 

Tty and pty print the path name of the user's terminal. The -s option inhibits printing of the 
terminal path name, and is used to test just the exit code. 

RETURN VALUE 

Standard input is a terminal if tty was invoked or a pseudo-terminal if pty was 
invoked. 

1 Standard input is not a terminal or pseudo-terminal. 

2 Invalid options were specified. 

DIAGNOSTICS 

not a tty Standard input is not a terminal and -s was not specified in the tty com- 

mand. 

not a pty Standard input is not a pseudo-terminal and -s was not specified in the pty 

command. 
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NAME 

111 - do underlining 

SYNOPSIS 

111 [ -t terminal ] [ -i ] [ name ... ] 

DESCRIPTION 

Ul reads the named files (or standard input if none are given) and translates occurrences of under- 
scores to the sequence which indicates underlining for the terminal in use, as specified by the 
environment variable TERM. The -t option overrides the terminal kind specified in the environ- 
ment. The fermm/o(4) file corresponding to TERM is read to determine the appropriate 
sequences for underlining. If the terminal is incapable of imderlining, but is capable of a standout 
mode then that is used instead. If the terminal can overstrike, or handles underlining automati- 
cally, ul degenerates to cat{l). If the terminal cannot imderline, underlining is ignored. 

The -i option causes ul to indicate underlining onto by a separate line containing appropriate 
dashes '-'; this is useful when you want to look at the underlining which is present in an nroff 
output stream on a crt-termin£il. 

FILES 

/usr/lib/terminfo/?/* terminal capability files 

AUTHOR 

Ul was developed by the University of California, Berkeley California, Computer Science Division, 
Department of Electrical Engineering and Computer Science. 

SEE ALSO 

man(l), nroff(l). 

BUGS 

Nroff usu£illy outputs a series of backspaces and underlines intermixed with the text to indicate 
underlining. No attempt is made to optimize the backward motion. 

INTERNATIONAL SUPPORT 

8-bit data and filenames. 
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NAME 

umask - set file-creation mode mask 

SYNOPSIS 

umask [ ooo ] 

DESCRIPTION 

The user file-creation mode mask is set to ooo. The three octal digits refer to read/write/execute 
permissions for owner, group, and others, respectively (see chmod{2) and umask(2)). The value 
of each specified digit is subtracted from the corresponding "digit" specified by the system for the 
creation of a file (see creat{2)). For example, umask 022 removes group and others write per- 
mission (files normally created with mode 777 become mode 755; files created with mode 666 
become mode 644). 

If 000 is omitted, the current value of the mask is printed with foiu: octal digits. The first digit, a 
zero, specifies that the output is expressed in octal. 

Umask is recognized and executed by the shell. 

Note that the file creation mask does not affect the set-user-ID, set-group)-ID, or "sticky" bits. 

SEE ALSO 

chmod(l), sh(l), chmod(2), creat(2), umask(2). 
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NAME 

umodem - XMODEM-protocol file transfer program 

SYNOPSIS 

umodem [ -options ] files 
umodem -c 

DESCRIPTION 

Umodem is a file transfer program that incorporates the well-known XMODEM protocol used on 
CP/M systems and on the HP 110 portable computer. 

Options 

-1 Employ TERM II FTP 1. 

-3 Enable TERM FTP 3 (CP/M UG). 

-7 Enable 7-bit transfer mask. 

-a Turn on ARPA Net flag. 

-c Enter command mode. 

-d Do not delete timodem.log before starting. 

-1 Turn on entry logging. 

-m Allow overwriting of files. 

-p Print all messages. 

-r(t b] Receive file. Specify t for text, or b for binary. 

-sft b] Send file. Specify t for text, or b for binary. 

-y Display file status only. 

EXAMPLES 

To receive a text file: 

umodem -rtJ file 
To receive a binary file: 

umodem -rhfile 
To send a text file: 

umodem -at7 file 
To send a binary file: 

umodem -ahfile 

AUTHOR 

Umodem is in the public domain. 

SEE ALSO 

kermit(l), cu(l), uucp(l). 
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NAME 

uname - print name of current HP-UX version 

SYNOPSIS 

uname [ -snrvmia ] 

DESCRIPTION 

Uname prints the ciurent system name of the HP-UX system on the standard output file. It is 
mainly useful to determine which system one is using. The options cause selected information 
returned by uname {2) to be printed: 

-8 print the system name (default). 

-n print the nodename (the nodename may be a name that the system is known by open a 
communications network), (e.g. uucp). 

-r print the operating system release. 

-V print the operating system version. 

-m print the machine hardware name. 

-i print the nodename if the machine identification number cannot be ascertained. 

-a print all the above information. 

SEE ALSO 

hostname(l), gethostname(2), sethostname(2), uname(2). 
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NAME 

unget - undo a previous get of an SCCS file 

SYNOPSIS 

unget [-rSID] [-s] [-n] files 

DESCRIPTION 

Unget undoes the effect of a get -e done prior to creating the intended new delta. If a directory 
is named, unget behaves as though each file in the directory were specified as a named file, except 
that non-SCCS files and unreadable files Eire silently ignored. If a name of - is given, the standard 
input is read with each line being taken as the naiae of an SCCS file to be processed. Refer to 
aoct(l), which describes how to determine what deltas are currently binding for an s-file. 

Keyletter arguments apply independently to each named file. 

-rSID Uniquely identifies which delta is no longer intended. (This would have been 

specified by get as the "new delta"). The use of this keyletter is necessary 
only if two or more outstanding gets for editing on the same SCCS file were 
done by the same person (login name). A diagnostic results if the specified 
SID is ambiguous, or if it is necessary and omitted on the commsind line (see 
sact{l)). 

-8 Suppresses the printout, on the standard output, of the intended delta's SID. 

-n Causes the retention of the gotten file which would normally be removed from 

the current directory. 

Note: unget can only be executed by the user who did the corresponding get -e. If a sys- 
tem administrator needs to unget a get -e done by another user, he must either use s«(l) 
to change into that user, or edit the p-file directly (which can be done either by the s-file 
owner or the super-user). 

FILES 

p-file see delta{l). 

g-file see delta{l). 

SEE ALSO 

delta(l), get(l), help(l), sact(l). 

DIAGNOSTICS 

Use help{l) for explanations. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

uniq - report repeated lines in a file 

SYNOPSIS 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, the second and succeeding 
copies of repeated lines are removed; the remainder is written on the output file. Input and out- 
put should always be different. Note that repeated lines must be adjacent in order to be found; 
see sort{l). If the -u flag is used, just the lines that are not repeated in the original file are out- 
put. The -d option specifies that one copy of just the repeated lines is to be written. The normal 
mode output is the imion of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in default style but with 
each line preceded by a count of the number of times it occurred. 

The n argmnents specify skipping an initial portion of each line in the comparison: 

-n The first n fields together with any blanks before each are ignored. A field is defined as 

a string of non-space, non-tab characters separated by tabs and spaces from its neigh- 
bors. 

-\-n The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

comm(l), sort(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

units - conversion program 

SYNOPSIS 

units [- file] 

DESCRIPTION 

Units converts quantities expressed in various standard scales to their equivalents in other scales. 
It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units optionally preceded by a numeric 
miiltiplier. Powers are indicated by suffixed positive integers, and division by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

♦ 1.020689e+00 
/ 9.797299e-01 

Units only does multiplicative scale changes; thus it can convert Kelvin to Rankine, but not Cel- 
sius to Fahrenheit. Most familiar imits, abbreviations, and metric prefixes are recognized, 
together with a generous leavening of exotica and a few constants of nature including: 

pi ratio of circmnference to diameter 

c speed of light 

e charge on an electron 

g acceleration of gravity 

force same as g, 

mole Avogadro's niunber, 

water pressure head per rniit height of water, 

au astronomical imit. 

Pound is not recognized as a unit of mass; lb is. Compound names are nm together, (e.g., 
lightyear). British units that differ &om their U.S. counterparts are prefixed thus: brgallon. 
For a complete list of units, tjrpe: 

cat /usr/lib/unittab 

An alternate unit database file can be specified for use with the '- file' option. Units will look in 
this file rather than the default /usr/lib/imittab for the table of conversions. This must be in the 
same format as /usr/lib/imittab. This is useful in defining yoiu* own units and conversions. 

WARNINGS 

The monetary exchange rates are out of date. 

FILES 

/usr/lib/unittab 
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NAME 

upm - unpack cpio archives from HP media 

SYNOPSIS 

upm -E [ cdmtuvx ] pathname chardevice [ patterns ] 

upm -iM [ cdmtuvx ] ( patterns ] </dev/nnf? 

Remarks: 

Upm is implemented on the Series 500 only. 

DESCRIPTION 

Upm is similar to cpto(l), and is included to enable you to restore files from 88140L/S tape car- 
tridges or 5.25-inch flexible discs more efficiently. 

Upm -E (copy in from tape cartridge) extracts all files specified by patterns from the file named 
by pathname (assumed to be the product of a previous cpio -o). Patterns is a series of zero or 
more blank-separated character strings given in the name-generating notation of sh{\). Note that 
the metacharacters ?, *, and [...] match the slash (/) when used in patterns. The default pattern 
is '*', which selects all files. Chardevice identifies the character special device file describing the 
volume containing pathname. (Note that, if this volume is not the root, it must be mounted at 
the time upm is used, and pathname must include the directory name on which the volume is 
mounted.) 

Upm -iM (copy in) extracts all files selected by zero or more of the specified patterns (see above 
for a description of patterns). The files are extracted from the standard input, which is redirected 
from a raw miniature flexible disc device /dev/rmf?. The resulting standard input is assimied to 
be the product of a previous cpio -o. 

Any other options specified must be concatenated with the initial E or iM options. The options 
have the following meanings: 

c read header information which was previously written in ASCII character form for portabil- 
ity; 

d directories are to be created as needed; 

m retain previous file modification time. This option is ineflFective on directories that are being 
copied; 

t print a table of contents of the input; no files are created; 

u copy unconditionally (normally, an older file will not replace a newer file with the same 
name); 

v verbose; causes a list of file names to be printed. When used with the t option, the table of 
contents looks like the output of an fa -/ command (see /s(l)); 

X restore device special files; mknod{2) is used to recreate these files, and thus -Ex or -iMx 
can only be used by the super-user. Restoring device files onto a diffierent system can be very 
dangerous. This is intended for backup use; 

When the end of a volume is reached, upm will prompt the user for the next flexible disc and con- 
tinue. 

The nmnber of blocks reported by upm is always in units of 512-byte blocks, regardless of the 
block size of the initialized media. 

SEE ALSO 

cpio(l), tcio(l), mknod(2). 

WARNING 

The -B option must not be used when performing raw I/O using the HP 9130K miniature flexible 
disc drive. 

BUGS 

Only the super-user can copy special files. 
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If /dev/tty is not accessible, upm issues a complaint, or refuses to work. 
The -Edr and -iMdr options will not make empty directories. 
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NAME 

uucp, uulog, uuname - UNIX system to UNIX system copy 

SYNOPSIS 

uucp [ options ] source-files destination-file 

uulog [ options ] 

uuname [ -1 ] [ -v ] 

DESCRIPTION 
Uucp 

Uucp copies files named by the source-file argmnents to the destination-file argument. A file 
name may be a path name on your machine, or may have the form: 

system-nameipath-name 

where system-name is taken from a list of system names which uucp knows about. The system- 
name may also be a list of names such as 

system-name!system-name!...!system-name!path-name 

in which case an attempt is made to send the file via the specified route, and only to a destination 
in PUBDIR (see below). Care should be taken to insure that intermediate nodes in the route are 
willing to foward information. 

The shell metacharacters ?, * and [ . . . ] appearing in path-name will be expanded on the 
appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by 'user where user is a login name on the specified sys- 
tem and is replaced by that user's login directory; 

(3) a path name preceded by ~ juser where user is a login name on the specified sys- 
tem and is replaced by that user's directory imder PUBDIR (see FILES); 

(4) anything else is prefixed by the current directory. 

The local and remote system access to the path name is specified in the USERFILE. If the result is 
an erroneous path name for the remote system the copy will fail. If the destination-file is a direc- 
tory, the last part of the source-file name is used. The accessibility of the file or path name is 
specified in USERFILE. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write permis- 
sions (see chmod(2)). 

The following options are interpreted by uucp: 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

-c Use the source file when copying out rather thsin copying the file to the spool directory 

(default). 

-C Copy the source file to the spool directory immediately and use the copy. 

-mfile Report status of the transfer in file. If file is omitted, send mail to the requester when the 
copy is completed. 

-nuser Notify user on the remote system that a file was sent. 

-esys Send the uucp command to system sys to be executed there. (Note: this will only be suc- 
cessful if the remote machine allows the uucp command to be executed by 
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/usr/lib/uucp/uuxqt . ) 

-ggrade 

Request grade as a priority for the work sequencing. Grades are specified in the order A 
- Z, a - z, with A specifying that the work should be done first, and z specifying that the 
work should be done last. All other grades specify a sequence somewhere in between. 
The default is n. 

—r Queue job but do not start the file transfer process. By default a file transfer process is 

started each time uucp is evoked. 

-j Control writing of the uucp job mmiber to standard output (see below). 

Uucp associates a job nimiber with each request. This job nimiber can be used by uustat to 
obtfdn status or terminate the job. 

The enviroimient variable JOBNO and the -j option are used to control the listing of the uucp 
job number on standard output. If the enviroimient variable JOBNO is undefined or set to 
OFF, the job number will not be listed (default). If uucp is then invoked with the -j option, the 
job number will be listed. If the environment variable JOBNO is set to ON and is exported, a 
job number will be written to standard output each time uucp is invoked. In this case, the -j 
option will supress output of the job number. 

Uulog 

Uulog queries a summary log of uucp and uuz(l) transactions in the file 
/usr/spool/uucp/LOGFILE. 

The options cause uulog to print logging information: 

-asys Print information about work involving system sys. If sys is not specified, then logging 
information for all systems will be printed. 

-uuaer Print information about work done for the specified user. If user is not specified then log- 
ging information for all users will be printed. 

Uuname 

Uuname lists the uucp names of known systems. Duplicate lines are not shown, but blank lines 
are. The -1 option returns the local system name. The -v option will print additional informa- 
tion about each system. A description will be printed for each system that has a line of informa- 
tion in /usr/lib/uucp/ ADMIN. The format of ADMIN is: syaname tab description tab. 

FILES 

/usr/lib/uucp/* other data and program files 

/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory for receiving and sending (PUBDIR) 

SEE ALSO 

mail(l), uux(l), chmod(2). 

WARNING 

The domain of remotely accessible files can (and for obvious security reasons, usually should) be 
severely restricted. You will very likely not be able to fetch files by path name; ask a responsible 
person on the remote system to send them to you. For the same reasons, you will probably not 
be able to send files to arbitrary path names. As distributed, the remotely accessible files are 
those whose names begin /usr/spool/uucppublic (equivalent to ~uucp or just ~). Note that, if 
/etc/passwd contains a blank line, a null user entry, or an entry for "uucp, then ~ and ~uucp will 
not expand properly. Because of this, the uuto script will not send files to the proper directory. 

NOTES 

In order to send files that begin with a dot (e.g., .profile) the files must by qualified with a dot. 
For example: .profile, .prof*, .profil? are correct; whereas *proP, ?profile are incorrect. 
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Uucp will not generate a job number for a strictly local transaction. 

BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. Receiving multiple files 

specified by special shell characters ? * [ . . . ] will not activate the -m option. 

The -m option will not work if all transactions are local or if uucp is executed remotely via the 

-« option. 

The -n option will function only when the source and destination are not on the same machine. 

Only the first seven characters of a system-name are significant. Any excess characters are 

ignored. 

If uulog is issued with no parameters when a uucp process is writing to a temporary logfile, some 
log information (that information written after the LOG.* files are imlinked) may be lost. 

Uucp, when used to copy files locally, will create the new file with mode 644 instead of 666. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames. 
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NAME 



uustat - UUCP status inquiry and job control 



SYNOPSIS 

uustat 



options 



DESCRIPTION 

Uustat will display the status of, or cancel, previously specified uucp commands, or provide gen- 
eral status on uucp connections to other systems. At most one of the following options may be 
specified: 

-jjobn Report the status of the uucp request jobn. If all is used for jobn, the status of all 
uucp requests is reported. An argument must be supplied otherwise the usage message 
will be printed and the request will fail. 

-kjobn Kill the uucp request whose job number is jobn. The killed uucp request must belong 
to the person issuing the uustat command imless that person is the super-user. 

—Tjobn Rejuvenate jobn. That is, jobn is touched so that its modification time is set to the 
current time. This prevents uuclean from deleting the job until the jobs modification 
time reaches the limit imposed by uuclean. 

—chour Remove the status entries which are older than hour hours. This administrative 
option can only be initiated by the user uucp or the super-user. 

-mmch Report the status of accessibility of machine mch. If mch is si)ecified as all, then the 
status of all machines known to the local uucp aie provided. 

-Mmc/i This is the same as the -m option except that two times are printed. The time that 
the last status was obtained and the time that the last successful transfer to that sys- 
tem occurred. 

If none of the above options are specified, any or all of the following options may appear: 

—uuser Report the status of all uucp requests issued by user. 

—ssys Report the status of all uucp requests which conununicate with remote system sys. 

-ohour Report the status of all uucp requests which are older than hour hours. 

-yhour Report the status of all uucp requests which are yoimger than hour hours. 

-O Report the uucp status using the octal status codes listed below. If this option is not 

specified, the verbose description is printed with each uucp request. 

-q List the number of jobs and other control files queued for each machine and the time 

of the oldest and youngest file queued for each machine. If a lock file exists for that 
system, its date of creation is listed. 

When no options are given, uustat outputs the status of all uucp requests issued by the current 
user. 

For example, the command: 

uustat -uhdc -smhtsa -y72 

will print the status of all uucp requests that were issued by user hdc to communicate with sys- 
tem mhtsa within the last 72 hours. The meanings of the job request status are: 

job-number user remote-system command-time status-time status 

where the status may be either an octal number or a verbose description. The octal code 
corresponds to the following description: 

OCTAL STATUS 

000001 the copy failed, but the reason cannot be determined 

000002 permission to access local file is denied 
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000004 permission to access remote file is denied 

000010 bad uucp command is generated 

000020 remote system cannot create temporary file 

000040 cannot copy to remote directory 

000100 cannot copy to local directory 

000200 local system cannot create temporary file 

000400 cannot execute uucp 

001000 copy (partially) succeeded 

002000 copy finished, job deleted 

004000 job is queued 

010000 job killed (incomplete) 

020000 job killed (complete) 

The meanings of the machine accessibility status are: 

system-name time status 

where time is the latest status time and status is a self-explanatory description of the machine 
status. 



FILES 



/usr/lib/uucp/L stat 

/usr/lib/uucp/R stat 

/usr/spool/uucp 



system status file 
request status file 
spool directory 



SEE ALSO 

uucp(l). 
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NAME 

uuto, uupick - public UNIX system to UNEC system file copy 

SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ -8 system ] 

DESCRIPTION 

Uuto sends source-files to destination. Uuto uses the «ucp(l) facility to send files, while it allows 
the local system to control the file access. A source-file name is a path name on your machine. 
Destination has the form: 

system! user 

where system is taken from a list of system names that uucp knows about (see uuname on 
uucp(l)). Logname is the login name of someone on the specified system. 

Two options are available: 

-p Copy the source file into the spool directory immediately, and send the copy. 

-na Send mail to the requester when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on system, where PUBDIR is 
the uucp public directory (/usr/spool/uucppublic). Specifically the files are sent to 

PUBDIR/receive/ user/ myays<em/files. 

The recipient is notified by mail{l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the recipient. Specifically, uupick searches PUB- 
DIR for files destined for the user. For each entry (file or directory) foimd, the following message 
is printed on the stemdard output: 

from system: [file file-name] [dir dirname] ? 

Uupick then reads a line from the standard input to determine the disposition of the file: 

<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir (current directory is default). Note 

that, if the current working directory is desired for dir, you shoidd not specify 
any parameter with m. A construction like m. is erroneous, emd results in loss 
of data. 

a [ dir ] Same as m except move all the files sent from system. 

p Print the contents of the file. 

q Stop. 

EOT (control-d) Same as q. 

! command Escape to the shell to do command. 

* Print a command summary. 

Uupick invoked with the ssystem option will only search the PUBDIR for files sent from system. 

FILES 

PUBDIR/usr/spool/uucppublic public directory 

NOTES 

In order to send files that begin with a dot (e.g., .profile) the files must by qualified with a dot. 
For example: .profile, .prof*, .profil? are correct; whereas *proP, ?profile are incorrect. 
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SEE ALSO 

mail(l), uuclean(lM), tiucp(l), uu8tat(l), uux(l). 
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NAME 

unx - UNIX system to UNIX system command execution 

SYNOPSIS 

uux [ options ] command-string 

DESCRIPTION 

Uux will gather zero or more files from various systems, execute a command on a specified system 
and then send standard output to a file on a specified system. Note that, for security reasons, 
many installations will limit the list of commands executable on behalf of an incoming request 
from uux. Many sites will permit little more than the receipt of mail (see mo»7(l)) via uux. 

The command-string is made up of one or more arguments that look like a shell command line, 
except that the command and file names may be prefixed by system-namel. A null system-name 
is interpreted as the local system. 

File names may be one of: 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on the specified system 
and is replaced by that user's login directory; 

(3) anything else is prefixed by the current directory. 
As an example, the command 

uux " !diff usg!/usr/dan/fl pwba!/a4/dan/fl > Ifl.diff" 

will get the fl files firom the "usg" and "pwba" machines, execute a diff command and put the 
results in fl.diff in the local directory. 

Any special shell characters such as <>;| should be quoted either by quoting the entire 
command-string, or quoting the special characters as individual argimients. 

Uux will attempt to get all files to the execution system. For files which £ire output files, the file 
name must be escaped using parentheses. For example, the conunand 

uux aluucp b!/usr/file \(c!/usr/file\) 

will send a uucp command to system "a" to get /usr/file from system "b" and send it to system 
"c". 

Uux will notify you if the requested command on the remote system was disallowed. The 
response comes by remote mail from the remote machine. The Eimount of mail notification can be 
reduced with the -z option, which notifies the remote system only if the command failed. 
Notification can be disabled totally with the -n option. Executable commands are listed in 
/usr/lib/uucp/L.cmds on the remote system. The format of the L.cmds file is: 

cmd,machinel ,machine2,. . . 

If no machines are specified, then any machine can execute cmd. If machines are specified, only 
the listed machines can execute cmd. If the desired command is not listed in L.sys then no 
machine can execute that command. 

Redirection of stsindard input and output is usually restricted to files in PUBDIR. Directories into 
which redirection is allowed must be specified in /usr/lib/uucp/USERFILE by the system 
administrator. 

The following options are interpreted by uux: 

- The standard input to uux is made the standard input to the command-string. 

-n Send no notification to user. 
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— z Send notification only of failures to user. 

-mfile 

Report status of the transfer in file. If file is omitted, send mail to the requester when the 
copy is completed. 

-j Control writing of the uucp job number to standard output. 

-r Queue job but do not start the file transfer process. By default a file transfer process is 
stEirted each time uux is evoked. 

Uux associates a job number with each request. This job number can be used by uustat to obtain 
status or terminate the job. 

The environment vsiriable JOBNO and the -j option are used to control the listing of the uux job 
number on standard output. If the environment variable JOBNO is undefined of set to OFF, the 
job nmnber will not be listed (default). If uuco is then invoked with the -j option, the job 
number will be listed. If the environment variable JOBNO is set to ON and is exported, a job 
number will be written to standard output each time uux is invoked. In this case, the -j option 
will suppress output of the job nmnber. 

FILES 

/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory (PUBDIR) 

/usr/lib/uucp/* other data and programs 

SEE ALSO 

mail(l), uuclean(lM), uucp(l). 

BUGS 

Only the first command of a shell pipeline may have a system-namel. All other commands are 

executed on the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. The shell 

tokens << and >> are not implemented. 

Only the first seven characters of the system-name are significant. Any excess characters are 

ignored. 
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NAME 

uxgen - generate an hp-ux system 

SYNOPSIS 

uxgen [-s] infile 

DESCRIPTION 

Uxgen 'is used to build an hp-ux system. The user supplies a set of instructions in infile which 
select optional parts of the kernel (eg. I/O drivers, pseudo-drivers) and specify values for system 
parameters such as the location of the swap area. 

The files output by tixgen are placed in the directory ../infile. This directory is created if it does 
not exist. Three files (conf.c, config.h, devices) are created by uxgen. The file "devices" contains a 
list of I/O devices, pseudo-drivers and major nmnbers assigned to them. This file is used by the 
commands insf{l), mksf{l) and lssf{l) for making and listing special files. In addition to infile, 
the file njimed "Makefile" must exist in the current directory. It will be copied to ../infile. 
Makefile is supplied with the system and contains targets for compiling conf.c and linking the ker- 
nel (hp-ux). 

After copying Makefile, uxgen changes the current directory to ../infile and executes a "make". If 
the -8 option is entered, then the make will not be executed. The make compiles conf.c and links 
the kernel (hp-ux). The file hp-ux may then be booted. See the System Administrators manual for 
information on how to boot the system. 

Many header files are needed to compile conf.c. Also, an archive library file containing the kernel 
objects is needed to link the kernel. These files are supplied with the system and are contained in 
the directories found under /etc/conf. The directories in /etc/conf may be moved to any location 
in the filesystem; however, all the directories must exist to build the kernel. By convention, infile 
is placed in the directory named "gen" (eg. /etc/conf/gen). 

The procedure for building a kernel follows: 

1. switch current directory to "gen" (cd /etc/conf/gen) 

2. edit or create infile 

3. execute uxgen {uxgen infile) 

4. New kernel is made and named ../in/i/e/hp-ux 

5. Save old /hp-ux file. 

6. Move ../inf He /hi>-ux to /hp-xix. 

7. Follow reboot instructions. 

It is beyond the scope of this man page to give a complete description of the statements which 
may be used in infile. A "loose" syntsix description for most statements is given below. See the 
Systems Administrators Manual for more information. 

The statements used in infile form a simple "C-like" language. Before being read, infile is passed 
through the "C preprocessor". This allows features such as comments, macros, file inclusion and 
conditional statements. See cpp(l) for more information about the C preprocessor. 

Generally, the first statement in infile is "#include /etc/master". This causes the statements in 
/etc/master to be read prior to the remaining statements in infile. /etc/master contains "driver" 
and "pseudo driver" statements which describe I/O drivers, pseudo-drivers and major number 
assignments for software supplied by HP. Only users who write kernel software (eg. drivers. 
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pseudo-drivers) need to understand these statements. They are described in the Systems Adminis- 
trators manual. All other statements are briefly described below. 

args on <module-id> lu <integer> section <integer> ; 

Specifies the module name, logical unit niunber and section nmnber to be used for writing 
the argument list during an "exec" system call. 

acctresume <integer> ; 

acctresume "<anychars>" ; 

Sp)ecifies the percentage of file system space which must be free to allow process accoimting 
to be reenabled after it has been suspended because of insufficient fi-ee space (see 
acctsuspend). 

acctsuspend <integer> ; 
acctsuspend "<anychars>" ; 

Specifies the percentage of file system space which must be free to allow process accounting 

(see acctresume). 

dst <integer> ; 

Specifies whether daylight savings time is to be used. A value of means not to use daylight 
savings time. A value of 1 indicates that USA daylight savings time is to be used. 

include <identifier> ; 

Causes a pseudo driver to be included in the kernel. 

io{ 

<identifier> lu <integer> address <integer> ; 

<identifier> address <integer> { 

<identifier> lu <integer> address <integer> ; 
} 



Specifies how many I/O devices and how they cire connected. 

maxdsiz <integer> ; 
maxdsiz "<anychars>" ; 

Specifies the maximum process data segment size (in bytes). 

maxssiz <integer> ; 
maxssiz "<anychars>" ; 

Specifies the maximum process stack size (in bytes). 

maxtsiz <integer> ; 
maxtsiz "<anychars>" ; 

Specifies the maximum process shared text segment size (in bytes). 

maxuprc <integer> ; 
maxuprc "<anychars>" ; 

Specifies the maximum number of processes that a user may have. 

maxusers <integer> ; 
maxusers "<anychars>" ; 
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Causes the macro MAXUSERS to be defined (eg. "#define MAXUSERS 8"). MAXUSERS 
is used to determine other tunable parameters (eg. nproc "(20 + 8 * MAXUSERS)";). 

msginap <integer> ; 
msgmap "<anychars>" ; 

Specifies the number of message map entries. 

msgmax <integer> ; 
msgmax "<anychars>" ; 

Specifies the maximum number of bytes in a message. 

msgmnb <integer> ; 
msginnb "<£inychars>" ; 

Specifies the msiximum number of bytes for all messages which are queued on a message 

queue. 

msginni <integer> ; 
msginni "<anychars>" ; 

Specifies the nmnber of message queue identifiers. 

msgseg <integer> ; 
msgseg "<anychars>" ; 

Specifies the nmnber of units (each msgssz bytes long) available for messages. 

msgssz <integer> ; 
tnsgssz "<anychars>" ; 

Specifies the size (in bytes) of each unit of memory used for messages (see msgseg). 

tnsgtql <integer> ; 
msgtql "<anychars>" ; 

Specifies the mmiber of message headers. 

nbuf <integer> ; 
nbuf "<anychars>" ; 

Specifies the number of filesystem buffer cache buffer headers. If nbuf is set to 0, the kernel 

will allocate 10 percent of available memory to buffer space. 

ncallout <integer> ; 
ncallout "<anychars> " ; 

Specifies the nmnber of timeouts which may be pending. 

nfile <integer> ; 
nfile "<anychars>" ; 

Specifies the maximum number of open files. 

nfiocks <integer> ; 
nflocks "<anychars>" ; 

Specifies the maximum number of file/record locks. 

ninode < integer > ; 
ninode "< cmy chars >" ; 

Specifies the maximum number of open in-core inodes. 
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nproc < integer > ; 
nproc "<anychars>" ; 

Specifies the maximum nmnber of processes which may simultaneously exist. 

npty <integer> ; 
npty "<anychars>" ; 

Specifies the number of pty's (pseudo ttys). 

ntext <integer> ; 
ntext "<anychars>" ; 

Specifies the maximum number of active shared text descriptors. 

remove <identifier> ; 

Removes a pseudo driver which was previously included with an include statement. 

root on <module-id> lu <integer> section <integer> 

Specifies module name, logical unit nmnber and section number for the root of the file sys- 
tem {"I"). 

semaem <integer> ; 
semaem "<anychars>" ; 

Specifies the maximum value a semaphore may be adjusted due to a process dying. 

semmap <integer> ; 
semmap "<anychars>" ; 

Specifies the number of semaphore map entries. 

semmni <integer> ; 
semmni "<anychars>" ; 

Specifies the nmnber of semaphore identifiers. 

semmns <integer> ; 
semnins "<anychars>" ; 

Specifies the maximum number of semaphores. 

semmnu <integer> ; 
semmnu "<anychars>" ; 

Specifies the maximum number of processes which can have pending "semaphore undo" 

requests on a semaphore. 

semume <integer> ; 
semume "<anychars>" ; 

Specifies the maximum number of semaphores on which a process may have a pending 

"semaphore undo" request. 

semvmx <integer> ; 
semvmx "<8mychars>" ; 

Specifies the maximum value that a semaphore can be. 

shmmax <integer> ; 
shnunax "< any chars >" ; 

Specifies the maximum number of bytes in a shared memory segment. 
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shmmni <integer> ; 
shinnini "<anychars>" ; 

Specifies the maximum mmaber of shared memory segments. 

shmseg <integer> ; 
shmseg "<anychars>" ; 

Specifies the maximimti mmiber of shared memory segments that can be simultaneously 

attached to a process. 

swap on <module-id> lu <integer> section <integer> 

[<module-id> lu <integer> section <integer>] ... ; 
Specifies the module name, logical unit number and section number to be used for swapping. 
Multiple swap areas may be defined. 

timeslice <integer> ; 
timeslice "<anychars>" ; 

Specifies the niunber of 10 millisecond intervals used for roimd-robin scheduling. A value of 

-1 disables roimd-robin scheduling. 

tiinezone <integer> ; 

Specifies the minutes west of Greenwich. 

unlockable mem <integer> ; 

unlockable mem "<anychars>" ; 

Specifies the nmnber of bytes of memory which cannot be locked. 



EXAMPLES 




args on 


discO lu section 1; 


acctresume 


4; 


acctsuspend 


2; 


console on 


muxO; 


dst 


1; 


dumps on 


discO lu section 1; 


maxdsiz 


0x8000; 


maxssiz 


0x1000; 


maxtsiz 


0x8000; 


maxuprc 


25; 


maxusers 


32; 


msgmap 


100; 


msgmax 


8192; 


msgmnb 


16384; 


msgmni 


50; 


msgseg 


1024; 


msgssz 


8; 


msgtql 


40; 


nbuf 


0; 


ncallout 


"(16 + NPROC)"; 


nfile 


" ( 16* (NPROC+ 16+MAXUSERS) / 10+32+2*NETSLOP) 


nflocks 


200; 


ninode 


"((NPROC + 16 + MAXUSERS) +32)"; 


nproc 


"(20 + 8 * MAXUSERS)"; 


npty 


60; 
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ntext 


"(24+MAXUSERS+NETSLOP) 


root on 


discO lu section 0; 


semaem 


16384; 




semmap 


10; 




semmni 


10; 




semmns 


60; 




semmnu 




30; 


semiune 


10; 




semvmx 


32767; 




shnunax 




0x4000000; 


shmmni 


100; 




shmseg 


12; 




swap on 


discO 


lu section 1 

discO lu 1 section 1; 


timeslice 




"(HZ/10)"; 


timezone 




8; 


unlockable_mem 


0; 



io{ 



cio caO address 28 { 

hpibO address { 



discO 
discO 



lu address 0; 
lu 1 address 1; 



} 

muxO 

hpibO 



lu address 1; 
address 2 { 



IprO 

tapeO 

instrO 



lu address 0: 
lu address 2 
lu address 7 



} 



} 



AUTHOR 

Uxgen was developed by HP. 

FILES 

/etc/devices(4) 

SEE ALSO 

insf(l), lssf(l), mksf(l). 
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NAME 

val - validate SCCS file 

SYNOPSIS 
val - 

val [-s] [-rSID] [-mname] [-ytype] files 

DESCRIPTION 

Val determines if the specified file is an SCCS file meeting the characteristics specified by the 
optional argiunent list. Argmnents to val may appear in any order. The arguments consist of 
keyletter argmnents, which begin with a -, and named files. 

Val has a special argmment, -, which causes reading of the standard input until an end-of-file con- 
dition is detected. Each line read is independently processed as if it were a commemd line argu- 
ment fist. 

Val generates diagnostic messages on the standard output for each command line and file pro- 
cessed, and also returns a single 8-bit code upon exit as described below. 

The keyletter arguments are defined as follows. The effects of any keyletter argument apply 
independently to each named file on the command line. 

-8 The presence of this argument silences the diagnostic message normally gen- 

erated on the standeird output for any error that is detected while processing 
each named file on a given command line. 

-rSID The argmnent value SID (5CCS /Dentification String) is an SCCS delta number. 

A check is made to determine if the SID is ambiguous (e.g., rl is ambiguous 
because it physically does not exist but implies 1.1, 1.2, etc., which may exist) or 
invalid (e. g., rl.O or rl.1.0 are invalid because neither case can exist as a valid 
delta nmnber). If the SID is valid and not Eunbiguous, a check is made to deter- 
mine if it actually exists. 

—mname The argiunent value name is compared with the SCCS %M.% keyword in file. 

—ytype The argmnent value type is compared with the SCCS %Y% keyword in file. 

The 8-bit code returned by val is a disjimction of the possible errors, i. e., can be interpreted as a 
bit string where (moving from left to right) set bits are interpreted as follows: 

bit = missing file argmnent; 

bit 1 = unknown or duplicate keyletter argmnent; 

bit 2 = corrupted SCCS file; 

bit 3 = cannot open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 = %M%, -m mismatch; 

Note that val can process two or more files on a given command line and in turn can process mul- 
tiple conmiand lines (when reading the standard input). In these cases an aggregate code is 
returned - a logical OR of the codes generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l). 

DIAGNOSTICS 

Use help{l) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any nmnber above 50 will produce a 
fatal error. 
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ESTTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

vc - version control 

SYNOPSIS 

vc [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 

DESCRIPTION 

The vc command copies lines from the standard input to the standard output imder control of its 
arguments and control statements encountered in the standard input. In the process of perform- 
ing the copy operation, user declared keywords may be replaced by their string value when they 
appear in plain text and/or control statements. 

The copying of lines from the standard input to the standard output is conditional, based on tests 
(in control statements) of kesrword values specified in control statements or as vc command argu- 
ments. 

A control statement is a single line beginning with a control character, except as modified by the 
-t keyletter (see below). The default control character is colon (:), except as modified by the -c 
keyletter (see below). Input lines beginning with a backslash (\) followed by a control character 
are not control lines and are copied to the standard output with the backslash removed. Lines 
beginning with a backslash followed by a non-control character are copied in their entirety. 

A keyword is composed of 9 or less alphanmnerics; the first must be alphabetic. A value is any 
ASCII string that can be created with ed(l); a niuneric value is an unsigned string of digits. Key- 
word values may not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword surroimded by control characters 
is encoimtered on a version control statement. The -a keyletter (see below) forces replacement of 
keywords in all lines of text. An vminterpreted control character may be included in a value by 
preceding it with \. If a literal \ is desired, then it too must be preceded by \. 

Keyletter Arguments 

-a Forces replacement of keywords surroimded by control cheiracters with their 

assigned value in all text Imes and not just in vc statements. 

-t All characters from the beginning of a line up to and including the first (06 char- 

acter are ignored for the purpose of detecting a control statement. If one is 
found, all characters up to and including the tab are discarded. 

-cchar Specifies a control character to be used in place of :. 

-8 Silences warning messages (not errors) that are normally printed on the diagnos- 

tic output. 

Version Control Statements 

:dcl keyword[, ..., keyword] 

Used to declare keywords. All keywords must be declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement overrides the assignment 
for the corresponding keyword on the vc command line and all previous asg's for 
that keyword. Keywords declared, but not assigned values have null values. 

:if condition 



:end 



Used to skip lines of the standard input. If the condition is true all lines between 
the if statement and the matching end statement are copied to the standard out- 
put. If the condition is false, all intervening lines are discarded, including control 



Hewlett-Packard Company - 1 - Version B.l, October 1986 



VC(1) HP-UX VC(1) 



statements. Note that intervenrng if statements and matching end statement 
are recognized solely for the purpose of maintaining the proper if-end matching. 
The sjmtax of a condition is: 



<cond> 

<or> 

<and> 

<exp> 

<op> 

<value> 



1= [ "not" ] <or> 

;= <and> I <and> " I " <or> 

;= <exp> I <exp> "&" <and> 

;= "(" <or> ")" I <value> <op> <value> 

;= "=" I "!=" I "<" I ->" 

<arbitrary ASCII string> I <numeric string> 



The available operators and their meanings are: 



= 


equal 


!= 


not equal 


k 


and 


1 


or 


> 


greater than 


< 


less than 





used for logical groupings 


not 


may only occur immediately after the if, and 




when present, inverts the value of the 




entire condition 



The > and < operate only on unsigned integer values (e.g., : 012 > 12 is false). 
All other operators take strings as arguments (e.g., : 012 != 12 is true). The pre- 
cedence of the operators (from highest to lowest) is: 

= != > < all of equal precedence 

ic 

I 
Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at least one blank or 
tab. 

Used for keyword replacement on lines that are copied to the standard output. 
The two leading control characters are removed, and keywords surroimded by 
control characters in text are replaced by their value before the line is copied to 
the output file. This action is independent of the —a keyletter. 



Turn on or off keyword replacement on all lines. 

Change the control character to char. 

Prints the given message on the diagnostic output. 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and retinas an exit code of 1. 
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SEE ALSO 

ed(l), help(l). 

DIAGNOSTICS 

Use help{l) for explanations. 

EXIT CODES 

- normal 

1 - any error 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

vi - screen-oriented (visual) display editor based on ex 

SYNOPSIS 

vi [ -t tag ] [ -r file ][-!][ -wn ] [ -x ] [ -R ] [ +command ] name ... 
view [ -t tag ] [ -r file ][-!][ -wn ] [ -x ] [ -R ] [ +command ] name ... 
vedit [ -t tag ] [ -r file ] [ -1 ] [ -wn ] [ -x ] [ -R ] [ +command ] name ... 

REMARKS 

The decryption facilities provided by this software are mider control by the United States Govern- 
ment and cannot be exported without special licenses. These capabilities are only available by 
special arrangment with HP. 

DESCRIPTION 

Vi (visual) is a display-oriented text editor based on an underlying line editor ear(l). It is possible 
to use the command mode of ex from within vi and vice- versa. 

When using vi, changes you make to the file are reflected in what you see on your terminal screen. 
The position of the cm-sor on the screen indicates the position within the file. Additional details 
on using vi emd ex can be foimd in the wandea; editor tutorials. 

INVOCATION 

The following invocation options are interpreted by vi: 

-t tag Edit the file containing the tag and position the editor at its definition. 

-r/i/e Recover file after an editor or system crash. If file is not specified a list of all 

saved files will be printed. 

-1 LISP mode; indents appropriately for lisp code, the () {} [[ and ]] commands in 

vi and open are modified to have meaning for lisp . 

-wn Set the default window size to n. This is useful when using the editor over a slow 

speed line. 

-X Encryption mode; a key is prompted for allowing creation or editing of an 

encrypted file. 

-R Read only mode; the readonly flag is set, preventing accidental overwriting of 

the file. 

+ command The specified ex command is interpreted before editing begins. 

The name argimient indicates files to be edited. 

The view invocation is the same as vi except that the readonly flag is set. 

The vedit invocation is intended for beginners. The report flag is set to 1, and the showmode 
and novice flags are set. These defaults make it easier to get started learning the editor. 

VI MODES 

Command Normal and initial mode. Other modes return to command mode upon comple- 

tion. ESC (escape) is used to csmcel a partial command. 

Input Entered byaiAIoOcCsSR. Arbitrary text may then be entered. Input 

mode is normally terminated with ESC character, or abnormally with interrupt. 

Last line Reading input for : / ? or !; terminate with CR to execute, interrupt to cancel. 

COMMAND SUMMARY 
Sample commands 

<— i t — ► arrow keys move the cursor 

hi j k 1 same as arrow keys 

ifear^ESC insert text abc 
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cwnewESC 
easESC 

X 

dw 

dd 

3dd 

u 

ZZ 

:q!CR 

/texiCR 

:ex cmdCR 



change word to new 
pluralize word 
delete a character 
delete a word 
delete a line 
delete 3 lines 
undo previous change 
exit vi, saving changes 
quit, discarding changes 
search for text 
scroll up or down 
any ex or ed command 



Counts before vi commands 

Nimibers may be typed as a prefix to some commands. They are interpreted in one of these ways, 
line/column niunber z G I 

scroll amoimt *D 'U 

repeat effect most of the rest 

Interrupting, canceling 

ESC end insert or incomplete cmd 

" ? (delete or rubout) interrupts 

"L reprint screen if *? scrambles it 



if aproon if "T. 



Wo^< 



File manipulation 




:wCR 


write back changes 


:qCR 


quit 


:q!CR 


quit, discard changes 


:e nameCR 


edit file name 


:e!CR 


reedit, discard changes 


:e + nomeCR 


edit, starting at end 


:e -l-nCR 


edit starting at line n 


:e #CR 


edit alternate file 




synonym for :e # 


:w nameCR 


write file name 


:w! nameCR 


overwrite file name 


:r nameCR 


read file name into text 


:<lineno>r nomeCR 


read file name into text starting at 




line <lineno> 


:r Icmd 


read output from cmd into text at cursor line 


:8hCR 


run shell, then return 


:!cmdCR 


nm cmd, then return 


:nCR 


edit next file in arglist 


:n argsCK 


specify new arglist 


G 


show current file and line 


:ta tagCR 


to tag file entry tag 


1 


:ta, following word is tag 


In general, any ex or < 


ed command (such as substitute or global) may be typed, preceded by a 


colon and followed by a 


CR. 
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Positioning within file 



*F 


forward screen 


B 


backward screen 


*D 


scroll down half screen 


V 


scroll up half screen 


G 


go to specified line (end default) 


/pat 


next line matching pat 


Tpat 


prev line matching pat 


n 


repeat last / or ? 


N 


reverse last / or ? 


/pat/+n 


nth line after pat 


"ipatl-n 


nth line before pat 


]] 


next section/function 


[[ 


previous section/function 


( 


beginning of sentence 


) 


end of sentence 


{ 


beginning of paragraph 


} 


end of paragraph 


% 


find matching ( ) { or } 


Adjusting tlie screen 


L 


clear and redraw 


•R 


retype, eliminate @ lines 


zCR 


redraw, current at window top 


z-CR 


... at window bottom 


z.CR 


... at window center 


/pot/z-CR 


pat line at window bottom 


zn. 


use n line window 


E 


scroll window down 1 line 


Y 


scroll window up 1 line 



Marlcing and returning 

move cursor to previous context 
... at first non- white in line 
mx mark current position with letter x 

" X move cursor to mark x 

'x ... at first non- white in line 

Line positioning 



H 


top line on screen 


L 


last line on screen 


M 


middle line on screen 


H- 


next line, at first non- white 


- 


previous line, at first non-white 


CR 


return, same as -|- 


iorj 


next line, same coliunn 


Tork 


previous line, same column 
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Character positioning 

first non white 






beginning of line 


$ 


end of line 


h or — » 


forward 


1 or <— 


backwards 


H 


same as ■«— 


space 


same as — » 


fx 


find X forward 


Fx 


f backward 


tx 


upto X forward 


Tx 


back upto X 


5 


repeat last f F t or T 


» 


inverse of ; 


1 


to specified column 


% 


find matching ( { ) or } 


Words, sentences, paragraphs 


w 


word forward 


b 


back word 


e 


end of word 


) 


to next sentence 


} 


to next paragraph 


/■ 

V 


back sentence 


{ 


back paragraph 


W 


blank delimited word 


B 


back W 


E 


to end of W 



Commands for LISP Mode 

) Forward s-expression 

} ... but do not stop at atoms 

( Back s-expression 

{ ... but do not stop at atoms 

Corrections during insert 

"H erase last character 

"W erase last word 

erase your erase, same as "H 

kill your kill, erase input this line 

\ quotes "H, yom- erase and kill 

ESC ends insertion, back to command 

"i interrupt, terminates insert 

"D ("caret cntl-D") kill autoindent for one line 

O'D kill autoindent for duration of insertion 

'V quote non- printing character 

Insert and replace 

a append after cursor 

i insert before cursor 

A append at end of line 

I insert before first non-blank 

o open line below 

O open above 

ra; replace single char with x 
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RtexfESC replace characters 

Operators 

Operators are followed by a cursor motion, and affect all text that would have been moved over. 
For example, since w moves over a word, dw deletes the word that would be moved over. Dou- 
ble the operator, e.g. dd to affect whole lines. 

d delete 

c change 

y yank lines to buffer 

< left shift 

> right shift 

! filter through command 

= indent for LISP 



Miscellaneous Operations 



c 


change rest of line (c$) 


D 


delete rest of line (d$) 


s 


substitute chars (cl) 


S 


substitute lines (cc) 


J 


join lines 


X 


delete characters (dl) 


X 


... before cursor (dh) 


Y 


yank lines (yy) 



Yank and Put 

Put inserts the text most recently deleted or yanked. However, if a buffer is named, the text in 
that buffer is put instead. 

p put back text after cursor 

P put before cm-sor 

"xp put from buffer x 

"xy yank to buffer x 

"xd delete into buffer x 

Undo, Redo, Retrieve 

u undo last change 

U restore current line 

repeat last change 
"dp retrieve cPth last delete 

WARNINGS 

On some small machines, vi does not support the full command set due to space limitations. The 
commands which are not supported are detailed in "An Introduction to Display Editing with Vi". 
The most notable commands which are missing are the macro and abbreviation facilities, and the 
vedit invocation. (Since arrow keys are done with macros, arrow keys do not work on such 
machines.) 

Software tabs using ' T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals do not make use of insert and delete character opera- 
tions in the terminal. 

HARDWARE DEPENDENCIES 

Series 500 

(For HP27128A Asynchronous Serial Interface, HP27130A 8-Channel Asynchronous Mul- 
tiplexor) On tty ports that support ENQ/ACK handshake and where that handshake is 
enabled ('stty ienqak'), the Control-F (*F, ASCII ACK) character is read by the interface 
and/or driver and discarded. In vi{l) this means that typing Control-F will not 
advance to the next page. Refer to stty{l) and termio{7) for information on alternate 
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handshakes, and how to disable ENQ/ACK. 

AUTHOR 

Vt' and ex were developed by the University of California, Berkeley Cfilifomia, Computer Science 
Division, Department of ElectricEil Engineering and Computer Science. 

SEE ALSO 

ex(l), edit(l). 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

vis, inv - make unprintable characters in a file visible or invisible 

SYNOPSIS 

vis [ -n ] [ -8 ] ( -t ] [ -u 1 [ -X ] file . . . 
inv [ -n ] [ -8 ] [ -t ] [ -u ] [ -X ] file . . . 

DESCRIPTION 

Vis reads characters from each file in sequence and writes them to the standard output, convert- 
ing those which are not printable into a visible form. Inv performs the inverse function, reading 
printable characters from each file and writing them, retmned if appropriate to non-printable 
form, to standard out. 

Non-printable characters are represented using C-like escape conventions: 

\\ backslash 

\b backspace 

\e escape 

\f form-feed 

\n new-line 

\r carriage return 

\8 space 

\t horizonteil tab 

\v vertical tab 

\n the 8-bit character whose ASCII code is the 3-digit octal number n. 

\xn the 8-bit character whose ASCII code is the 2-digit hexadecimal number n . 

Space, horizontal tab, and new line may be treated as printable (and therefore passed unscathed 
to the output) or non-printable dependent on the options selected. Backslash, although printable, 
is expanded by via, to a pair of backslashes so that when passed back through inv, it can be 
mapped back to a single backslash. 

If no input file is given, or if the argument - is encountered, vis and inv read fi-om the standard 
input file. 

The options are: 

-n causes new-line, space, and horizontal tab to be treated as non-printable charac- 

ters. Thus vis expands them visibly as \n, \8, £md \t, rather passing them 
directly to the output. Inv discards these character, expecting only the printable 
expansions. New-line characters are inserted by vis every 16 characters so that 
the output will be in form acceptable for most editors. 

-8 makes vis and inv silent about non-existent files, identical input £md output, and 

write errors. Normally, no input file may be the same as the output file unless it 
is a special file. 

-t treats horizontal tab and space as non-printable characters, in the same manner 

in which -n options treats them. 

-u causes output to be unbuffered (character-by-character); normally, output is 
buffered. 

-x causes vis output to be in hexadecimal form rather than the default octal form. 
Either form is accepted to inv as input. 

AUTHOR 

Vis was developed by the Hewlett-Packard Company. 

SEE ALSO 

cat(l), echo(l), od(l). 
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WARNING 

Command formats such as 

vis filel me2 >filel 
will cause the original data in filel to be lost. 

INTERNATIONAL SUPPORT 

8-bit and 16-bit data, customs, messages 
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NAME 

vmstat - report virtual memory statistics 

SYNOPSIS 

vmstat [ -dfsSz ] [ interval [ count ] ] 

DESCRIPTION 

Vmstat normally reports certain statistics kept about process, virtual memory, trap and cpu 
activity. If given a -d argument, it also reports disk transfer information in the form of transfers 
per second. If given a -f argmnent, it instead reports on the number of forks and vforks since sys- 
tem stEirtup and the nmnber of pages of virtual memory involved in each kind of fork. If given a 
-8 argument, it instead prints the contents of the sum structure, giving the total number of 
several kinds of paging related events that have occiu-red since boot. Giving a -S argument 
causes vmstat to execute normally with the exception that the nmnber of processes swapped in 
and out are displayed instead of page reclaims and address translation faults. The -z option 
requires super-user capabilities. It clears all accmnulators in the siun structure. 

If none of these options are given, vmstat will report in the first line a summary of the virtual 
memory activity since the system has been booted. If interval is specified, then successive lines 
£u-e summaries over the last interval seconds. The command vmstat 5 will print what the system 
is doing every five seconds. This is a good choice of printing interval since this is how often some 
of the statistics are sampled in the system; others vary every second. If a count is given, the 
statistics are repeated count times. The format fields cu-e: 

Procs: information about nmnbers of processes in various states. 

r in run queue 

b blocked for resources (i/o, paging, etc.) 

w nmnable or short sleeper (< 20 sees) but swapped 

Memory: information about the usage of virtual and real memory. Virtual pages are con- 

sidered £ictive if they belong to processes that are nmning or have run in the last 
20 seconds. 

avm active virtual pages 

free size of the free list 

information about page faults and paging activity. These are averaged each five 
seconds, and given in imits per second. 

re page reclaims 

at address translation faults 

pi pages paged in 

po pages paged out 

fr pages freed per second 

de anticipated short term memory shortfall 

sr pages scanned by clock algorithm, per-second 

trap/interrupt rate averages per second over last 5 seconds. 

in (non clock) device interrupts per second 

sy system calls per second 

cs cpu context switch rate (switches/sec) 

breakdown of percentage usage of CPU time 



Faults: 



Cpu: 
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us user time for normal and low priority processes 

sy system time 

id cpu idle 

AUTHOR 

Vmstat was developed by the University of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Computer Science. 

FILES 

/dev/kmem 
/hp-ux 
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NAME 

vstat - collect virtual memory performance statistics 

SYNOPSIS 

vstat command 

Remarks: 

Implemented only on the Series 500. 

DESCRIPTION 

Vstat uses system{3S) to execute the specified command. Upon completion, vatat prints the real, 
user, and system times for command plus coimts of several Virtual Memory operations that 
occurred while command was being executed. Statistics are printed to stderr. 

Virtual memory statistics are kept on a system-wide basis only, so all system Virtual Memory 
activity during the command's execution is reported by vstat. 

Two kinds of logical memory objects are supported by the Series 500 processor: tmpaged segments 
and paged segments. Unpaged segments are variable length objects that are typically used for 
code segments, stack segments, and some data segments. On the other hand, paged segments are 
divided into one or more pages of equal size, and can only be used for data. Paged segments are 
not limited to 512K bytes like impaged segments. Thus, a paged segment can provide a large 
address space and efficient memory use because unused pages can be swapped to backing storage. 
While an unpaged segment provides faster memory access time, it must be entirely resident when 
accessed. This diflFerence in memory efficiency can be illustrated by considering a program that 
accesses only the first two Kbytes of a 200-Kbyte array. If the array is allocated in a paged seg- 
ment, only those pages that contain the first two Kbytes need be resident in memory. If the array 
is allocated in an unpaged segment, the entire 200 Kbyte segment must be resident in order to 
access any given part of the array. 

Separate memory management algorithms are used for paged segments and impaged segments. 
The system keeps statistics for the operation of each algorithm. 

Statistics reported by vatat include: 

time information Process time information as in time(l). 

page faults Attempted accesses to addresses within absent pages. A page fault 

can be handled by recovering the page from the page cache, reading 
the page from backing storage, demand loading the page from the 
a.out file, or creating a new page in memory. The current page size 
for the system can be determined with uconfig(8). 

page writes Pages written to backing storage. 

page reads Pages read from backing storage. 

page dloads Pages demeind loaded from an a.out file. This indicates that demand 

loading has been specified by chatr(l). 

pages replaced Pages moved from a working set to the page cache by the working set 

scan algorithm. Replaced pages are not immediately swapped to 
backing storage. 

pages init'd Pages created £ind initialized to all zeroes m memory. 

normal scans The nimiber of working set scans performed by the paging system. 

mr scans The nmnber of FIFO scans performed by the paging system. FIFO 

scans are an override of the normal working-set algorithm. 
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segment faults Attempted accesses to addresses within absent unpaged segments. A 

segment fault can be handled by reading the segment from backing 
storage, demand loading the segment from the a.out file, or creating a 
new segment in memory. 

segment writes/bytes Segments/bytes written to backing storage. 

segment reads/bytes Segments/bytes read from backing storage. 

segment dloads/bytes Segments/bytes demand loaded from an a.out file. This indicates 
that demand loading has been specified by chatr(l). 

segment inits/bytes Segments/bytes created and initialized to all zeroes in memory. 

Several factors can keep the nmnerical totals from matching correctly. For example, simultaneous 
faults to shared code segments combined with the effects of the clustering algorithm in the paging 
system can prevent the total number of reads, demand loads, and inits from equalling the number 
of faults. 

EXAMPLES 

The conamand: 

vstat Is -1 /bin 

creates a shell to execute 'Is -1 /bin' and reports the resulting statistics to stderr. 

The command: 

vstai aleep 8G 

executes 'sleep 60' and has the effect of reporting on all system VirtuEil Memory activity over a 
60 second period. Note that the times information is relevant only to the sleep command and is 
not interesting in this example. 

The most practical use of vstat is to determine whether a program is virtual memory bound or 
CPU bound. Acciurate determination requires that no other system activity occur during com- 
mand execution. If user time plus system time (totfil CPU time) accounts for all or most of the 
elapsed time, the program is CPU boimd and virtual memory activity is probably not a major fac- 
tor. If elapsed time is greater than CPU time, the statistics for virtual memory I/O activity will 
show whether virtual memory is causing idle time. For page I/O, add the total nvunber of page 
reads, page writes, and page dloads, then multiply by 30 msec. For segment I/O, add the number 
of segment reads, segment writes, cind segment dloads, then multiply by 80 msec. If these times 
accoimt for a significant portion of the idle time, the program is probably virtual memory bound. 
The numbers for page and segment I/O time are gross approximations. They £ire useful for gen- 
eral analysis, but should not be used to predict performance. 

SEE ALSO 

time(l), times(2), chatr(l), ld(l), uconfig(lM) 

The section on Memory Management in the Concepts chapter of the HP-UX System Administra- 
tor Manual for the HP 9000 Series 500. 

WARNINGS 

Vstat requires an effective user id of root to execute. 

Statistics include the creation of the shell by the system(3s) library call. 
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NAME 

vt - login to another system over Ian 

SYNOPSIS 

vt nodename [ lein device ] 
vt -p [ Ian device ] 

DESCRIPTION 

vt enables a user to log in on another HP 9000 system ( nodename ) over an HP local area net- 
work. The -p option will cause vt to send a poll request over the local area network to find out 
what systems currently have vtdaemon(lM) running. An asterisk (*) following a nodename in the 
response indicates that the system is a vt gateway. Plus signs (-I-) following the nodename indicate 
how many vt gateways have to be traversed to reach that system. 

The optional argument Ian device specifies a character special device name to use instead of the 
default device name to send/receive data to/from the local area network. The major number for 
this device must correspond to a CIO IEEE802.3 local area network device. 

Once a connection has been established, vt enters input mode. In this mode, text typed is sent to 
the remote host. To issue vt commands when in input mode, precede them with the vt escape 
character. When in command mode, the normal terminal editing conventions are available. 

The connection should automatically be terminated upon logging off of the remote machine. If the 
connection is not terminated then this indicates that the ptydaemon on the remote system has 
either been terminated or restarted. In this case the user should enter command mode and use the 
quit command to terminate the connection. 

Commands 

The following commands are available. Only enough of each command to uniquely identify it 
need be typed. 

cd remote-directory 

Change the working directory on the remote machine to remote-directory. This command 
is applicable for file transfer only. 

escape [ escape-char ] 

Set the vt escape character. If a character is not specified vt will prompt for one. If 
current vt escape character will be printed if the user just hits return in response to this 
prompt. 



help 



Print a vt command summary. 



led [ directory ] 

Change the local working directory. If no directory is specified, use the user's home direc- 
tory. This command is applicable for file transfer and shell escapes only. 

get remote-file local-file 

receive remote-file local-file 

Retrieve the remote-file and store it on the local machine as local-file, vt will prompt for 
the file names if they are not specified. The file transfer can be aborted by typing the 
interrupt character or hitting the break key. 

put local-file remote-file 

send local-file remote-file 

Retrieve the local-file and store it on the remote machine as remote-file, vt will prompt for 
the file names if they are not specified. The file transfer can be aborted by typing the 
interrupt character or hitting the break key. 
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quit Terminate the connection and exit vt. 

user user-name[:[password[] 

Identify yourself to the remote vt server, vt will prompt for a password (after disabling 
local echo) if a colon (:) is appended to user-name. It is necessary to do this before any file 
transfer command can be used. 

! [ shellcommand ] 

Shell escape. The given command is given to a sub-shell to execute. If no command is 
given, then a shell is started and connected to the user's terminal. 

HARDWARE DEPENDENCIES 

Series 500: 

The HP 2285A Ian device is not supported by vt. 

FILES 

/dev/ieee default Ian device name. 

SEE ALSO 

vtdaemon(lM), lan(4) 

DIAGNOSTICS 

The diagnostics produced by vt are intended to be self-explanatory. 

WARNINGS 

vt uses the Hewlett-Packard LLA (Link Level Access) direct interface to the HP network drivers. 
vt uses the multicast address OxOlAABBCCBBAA. It should not be used or deleted by other 
applications accessing the network, vt uses the following IEEE 802.3 sap (service access point) 
values: 0x90, 0x94, 0x98, 0x9C, OxAO, 0xA4, OxA8, OxAC, OxBO, 0xB4, 0xB8, OxBC, 
OxCO, 0xC4, OxC8, OxCC, OxDO and 0xD4. They should not be used by other applications 
accessing the network. 
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NAME 

wait - await completion of process 

SYNOPSIS 
wait 

DESCRIPTION 

Wait until all processes started with & have completed, and report on abnormal terminations. 

Because the wait{2) system call must be executed in the parent process, the shell itself executes 
wait, without creating a new process. 

SEE ALSO 

sh(l), wait(2) 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the shell, and thus cannot be 
waited for. 
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NAME 

wc - word, line, and character coimt 

SYNOPSIS 

wc [ -Iwc ] [ names ] 

DESCRIPTION 

Wc counts lines, words, and characters in the named files, or in the standard input if no names 
appear. It also keeps a total count for £ill nsuned files. A word is a maximal string of characters 
delimited by spaces, tabs, or new-lines. 

The options 1, w, and c may be used in any combination to specify that a subset of lines, words, 
and characters are to be reported. The default is -Iwc. 

When names are specified on the command line, they will be printed along with the coimts. 

BUGS 

Wc coimts the number of new-lines to determine the line count. If an ASCII text file has a final 
line that is not terminated with a new-line character, the count will be oflF by one. 

If there are very many characters, words, and/or lines in sm input file, the output may be hard to 
read. This is because wc reserves a fixed column width for each covmt. 

INTERNATIONAL SUPPORT 

8-bit data, 8-bit filenames, messages. 
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NAME 

what - identify files for SCCS information 

SYNOPSIS 

what [-s] files 

DESCRIPTION 

What searches the given files for all occurrences of the pattern that get{\) substitutes for %Z% 
(this is @(#) at this printing) and prints out what follows until the first ", >, new-line, \, or null 
character. For example, if the C program in file f.c contains 

char ident[] = " @(#)identification information"; 

and f.c is compiled to yield f.o and a.out, then the command 

what f.c f.o a.out 

will print 

f.c: identification information 

f.o: identification information 

a.out: identification information 

What is intended to be used in conjunction with the SCCS conmiand </et(l), which automatically 
inserts identifying information, but it can also be used where the information is inserted manually. 
Only one option exists: 

-8 Quit after finding the first occurrence of pattern in each file. 

SEE ALSO 

get(l), help(l). 

DIAGNOSTICS 

Exit status is if any matches are found, otherwise 1. Use help{\) for explanations. 

BUGS 

It is possible that an imintended occurrence of the pattern @ @(#) could be found just by chance, 
but this causes no harm in nearly all cases. 

INTERNATIONAL SUPPORT 

8- and 16-bit data, 8-bit filenames, messages. 
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NAME 

whereis - locate source, binary, and/or manual for program 

SYNOPSIS 

whereis [ -bsm ] [ -u ] [ -BMS dir ... -f ] name ... 

DESCRIPTION 

Whereis locates source/binary and manuals sections for specified files. The supplied names are 
first stripped of leading pathname components and any (single) trailing extension of the form 
".ext", e.g. ".c". Prefixes of "s." resulting from use of SCCS are also dealt with. Whereis then 
attempts to locate the desired program in a list of standard places. If any of the -b, -a or -m 
flags are given then whereis searches only for binaries, sources or manual sections respectively (or 
any two thereof). The -u flag may be used to search for unusual entries. A file is said to be 
vmusual if it does not have one entry of each requested type. Thus "whereis -m -u *" asks for 
those files in the current directory which have no documentation. 

Finally, the -B -M and -S flags may be used to change or otherwise limit the places where 
whereis searches. The -f file flag is used to terminate the last such directory list and signal the 
start of file names. 

EXAMPLES 

The following finds £ill the files in /usr/bin which are not docmnented in /usr /man/man 1 with 
source in /usr/src/cmd: 

cd /usr/bin 

whereis -u -M /usr/man/manl -S /usr/src/cmd -f * 

WARNINGS 

Since the program uses chdir{2) to nm faster, pathnames given with the -M -S and -B must be 
full; i.e. they must begin with a "/". 

FILES 

/usr/src/* 

/bin, /etc, /lib, /usr/{bin, games, lib} 

/usr/man/* 

/usr/local/{man/*, bin, games, include, lib} 

/usr/contrib/{man/*, bin, games, include, lib} 

AUTHOR 

Whereis was developed by the University of California, Berkeley. 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

which ~ locate a program file including eiliases and paths 

SYNOPSIS 

which [ name ] ... 

DESCRIPTION 

Which takes a list of names and looks for the files which would be executed had these names been 
given as conmiands. Each argument is expanded if it is aliased, and searched for along the user's 
path. Both aliases £md path are taken from the user's .cshrc file. 

FILES 

"/.cshrc source of aliases and path values 

DIAGNOSTICS 

A diagnostic is given for names which are aliased to more than a single word, or if an executable 
file with the argument name was not foimd in the path. 

BUGS 

Which reports .cshrc aliases even when not invoked from csh. 



Hewlett-Packard Company - 1 - Version B.l, October 1986 



WHO(l) HP-UX WHO(l) 



NAME 

who - who is on the system 

SYNOPSIS 

who [-uTlHqpdbrtas] [ file ] 

who am i 

who am I 

DESCRIPTION 

Who can list the user's nsune, terminal line, login time, elapsed time since activity occurred on the 
line, and the process-ID of the command interpreter (shell) for each current system user. It exam- 
ines the /etc/utmp file to obtain its information. If file is given, that file is examined. Usually, 
file will be /etc/wtmp, which contains a history of all the logins since the file was last created. 

Who with the am i or ana I option identifies the invoking user. 

Except for the default -s option, the general format for output entries is: 

name [state] line time activity pid [conunent] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the system clock, as well as 
other processes spawned by the init process. These options are: 

-u This option fists only those users who are currently logged in. The name is the 

user's login name. The line is the name of the line as foimd in the directory 
/dev. The time is the time that the user logged in. The activity is the number 
of hours and minutes since activity last occurred on that particular line. A dot 
(.) indicates that the terminal has seen activity in the last minute and is there- 
fore "current". If more than twenty-four hours have elapsed or the line has not 
been used since boot time, the entry is marked old. This field is useful when try- 
ing to determine whether a person is working at the terminal or not. The pid is 
the process-ID of the user's shell. The comment is the comment field associated 
with this line as foimd in /etc/inittab (see inittab{4)). This can contain infor- 
mation about where the terminal is located, the telephone number of the dataset, 
type of terminal if hard-wired, etc. 

-T This option is the same as the -u option, except that the state of the terminal 

line is printed. The state describes whether someone else can write to that ter- 
minal. A -|- appears if the terminal is writable by 8inyone; a - appears if it is 
not. Root can write to all lines having a + or a - in the state field. If a bad 
line is encoimtered, a ? is printed. 

-1 This option lists only those lines on which the system is waiting for someone to 

login. The name field is LOGIN in such cases. Other fields are the same as for 
user entries except that the state field does not exist. 

-H This option will print column headings above the regular output. 

-q This is a quick who, displaying only the names and the number of users currently 

logged on. When this option is used, all other options are ignored. 

-p This option lists any other process which is currently active and has been previ- 

ously spawned by init. The name field is the name of the program executed by 
init as found in /etc/inittab. The state, line, and activity fields have no mean- 
ing. The comment field shows the id field of the line from /etc/inittab that 
spawned this process. See inittab{4). 
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This option displays all processes that have expired and not been respawned by 
init. The exit field appears for dead processes and contains the termination and 
exit values (as returned by wait{2)), of the dead process. This can be useful in 
determining why a process terminated. 

This option indicates the time jind date of the last reboot. 

This option indicates the current run-level of the init process. The last three 
fields contain the current state of init, the number of times that state has been 
previously entered, and the previous state. These fields are updated each time 
init changes to a different nm state. 

This option indicates the last change to the system clock (via the date{l) com- 
mand) by root. See au(l). 

This option processes /etc/utmp or the named file with all options turned on. 

This option is the default and lists only the name, line, and time fields. 



/etc/inittab 

/etc/utmp 

/etc/wtmp 

SEE ALSO 

date(l), login(l), init(l), mesg(l), su(l), wait(2), inittab(4), utmp(4). 

INTERNATIONAL SUPPORT 

8-bit filenames. 
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NAME 

whoami - print effective current user id 

SYNOPSIS 

whoami 

DESCRIPTION 

Whoami prints who you are. It works even if you are su'd, while 'who am i' does not since it uses 
/etc/utmp. 

FILES 

/etc/passwd Name data base 

AUTHOR 

Whoami was developed by the University of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

who (1). 
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NAME 

write - interactively write (talk) to another user 

SYNOPSIS 

write user [ line ] 

DESCRIPTION 

Write copies lines from yoiu: terminal to that of another user. When first called, it sends the mes- 
sage: 

Message from yourname (tty??) [ date ]... 

to the person you want to talk to. When it has successfully completed the connection, it also 
sends two bells to your own terminal to indicate that what you are typing is being sent. 

The recipient of the message should write back at this point. Communication continues imtil an 
end of file is read from the terminal, an interrupt is sent, or the recipient has executed "mesg n". 
At that point write writes EOT on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the line argiunent may be used to 
indicate which line or terminal to send to (e.g., ttyOO); otherwise, the first writable instance of 
the user foimd in /etc/utmp is assumed and the following message posted: 

user is logged on more than one place. 
You are connected to "terminal". 
Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesg{l) command. Writing to others 
is normally allowed by default. Certain commands, in particular nroff{l) and pr(l) disallow mes- 
sages in order to prevent interference with their output. However, if the user has super-user per- 
missions, messages can be forced onto a write-inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell to execute the rest of the 
line as a command. 

The following protocol is suggested for using write: when you first write to another user, wait for 
them to write back before starting to send. Each person should end a message with a distinctive 
sigiml (i.e., (o) for "over") so that the other person knows when to reply. The signal (oo) (for 
"over £ind out") is suggested when conversation is to be terminated. 



FILES 



/etc/utmp to find user 

/bin/sh to execute ! 



SEE ALSO 

mail(l), mesg(l), nroff(l), pr(l), sh(l), who(l). 

DIAGNOSTICS 

user is not logged on if the person you are trying to write to is not logged on. 

Permission denied if the person you are trying to write to denies that permission (with 

mesg). 
Warning: cannot respond, set mesg -y 

if your terminal is set to mesg n and the recipient cannot respond to 

you. 
Can no longer write to user if the recipient has denied permission {mesg n) after you had started 

writing. 
INTERNATIONAL SUPPORT 

8- and 16-bit data, messages. 
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NAME 

xargs - construct argument list(s) and execute command 

SYNOPSIS 

xargs [flags] [ command [ initial-argmnents ] ] 

DESCRIPTION 

Xarga combines the fixed initial-arguments with argiunents read from standard input to execute 
the specified command one or more times. The munber of arguments read for each command 
invocation and the manner in which they are combined are determined by the flags specified. 

Command, which may be a shell file, is searched for, using one's $PATH. If command is omitted, 
/bin/echo is used. 

Arguments read in from standard input are defined to be contiguous strings of characters delim- 
ited by one or more blanks, tabs, or new-lines; empty lines are Jilways discsirded. Blanks £ind tabs 
may be embedded as part of an argument if escaped or quoted. Characters enclosed in quotes 
(single or double) are taken literally, and the delimiting quotes are removed. Outside of quoted 
strings a backslash (\) will escape the next character. 

Each argmnent list is constructed starting with the initial-arguments, followed by some number of 
arguments read from stemdard input (Exception: see -i flag). Flags -i, -1, and -n determine how 
arguments are selected for each conunand invocation. When none of these flags £u:e coded, the 
initial-arguments aie followed by arguments read continuously from standard input \mtil an inter- 
nal buffer is full, and then command is executed with the accumulated args. This process is 
repeated until there are no more args. When there are flag conflicts (e.g., -1 vs. -n), the last flag 
has precedence. Flag values are: 

-Inumber Command is executed for each non-empty number lines of argmnents from 

standard input. The last invocation of command will be with fewer lines of 
argmnents if fewer than number remain. A line is considered to end with 
the first new-line unless the last character of the line is a blank or a tab; a 
trailing blank/tab signals continuation through the next non-empty line. If 
number is omitted, 1 is assmned. Option -x is forced. 

-ireplstr Insert mode: command is executed for each line from standard input, tak- 

ing the entire line as a single arg, inserting it in initial-arguments for esich 
occurrence of replstr. A maximvun of 5 argiunents in initial-arguments 
may each contain one or more instances of replstr. Blanks and tabs at the 
beginning of each line are thrown away. Constructed arguments may not 
grow larger than 255 characters, and option -x is also forced. { } is 
assmned for replstr if not specified. 

-nnumber Execute command using as many standard input arguments as possible, up 

to number arguments maximum. Fewer argmnents will be used if their 
total size is greater than size characters, and for the last invocation if there 
are fewer than number arguments remaining. If option -x is also coded, 
each number arguments must fit in the size limitation, else xargs ter- 
minates execution. 

-t Trace mode: The command and each constructed argiunent list are echoed 

to file descriptor 2 just prior to their execution. 

-p Prompt mode: The user is asked whether to execute command each invoca- 

tion. Trace mode (-t) is turned on to print the command instance to be 
executed, followed by a ?. . . prompt. A reply of y (optionally followed by 
anything) will execute the command; anything else, including just a car- 
riage retmn, skips that particular invocation of command. 
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—X Causes xargs to terminate if any argiiment list would be greater than size 

characters; -x is forced by the options -i and -1. When neither of the 
options -i, -1, or -n are coded, the total length of all arguments must be 
within the size limit. 

ssize The maximiun total size of each argument list is set to size characters; size 

must be a positive integer less than or equal to 470. If -s is not coded, 470 
is taken as the default. Note that the character coimt for size includes one 
extra character for each argmnent and the count of characters in the com- 
mand name. 

-eeofstr Eofstr is taken as the logical end-of-file string. Underbar ( ) is asstuned 

for the logical EOF string if -e is not coded. The value -e with no eofstr 
coded turns off the logical EOF string capability (underbar is taken 
literally). Xargs reads standard input until either end-of-file or the logical 
EOF string is encountered. 

Xargs will terminate if either it receives a return code of -1 from, or if it cannot execute, com- 
mand. When command is a shell program, it should explicitly exit (see sh{l)) with an appropri- 
ate vedue to avoid accidentally returning with -1. 

EXAMPLES 

The following will move all files from directory $1 to directory $2, and echo each move command 
just before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ } 

The following will combine the output of the parenthesized commands onto one line, which is then 
echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs >>log 

The user is asked which files in the current directory are to be archived and archives them into 
arch (1.) one at a time, or (2.) many at a time. 

1. Is I xargs -p -1 ar r arch 

2. Is I xargs -p -1 I xargs ar r arch 

The following will execute diff{l) with successive pairs of arguments origindly typed as shell argu- 
ments: 

echo $* I xargs -n2 diff 

SEE ALSO 

sh(l). 

DIAGNOSTICS 

Self-explanatory. 
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NAME 

xdb - C, FORTRAN, and Pascal Symbolic Debugger 

SYNOPSIS 

xdb (-d dir] [-r file] [-p file] [objectfile [corefile]] 

TABLE OF CONTENTS 

DESCRIPTION 
CONVENTIONS 

Notational Conventions 

Vsiriable Name Conventions 

Expression Conventions 

Procedure Call Conventions 
COMMANDS 

File Viewing Commands 

Display Formats 

Data Viewing and Modification Commands 

Stack Viewing Commands 

Job Control Commands 

Breakpoint Commands 

Assertion Control Commands 

Signal Control Commands 

Record and Playback Commands 

Macro Facility 

Miscellaneous Commands 
SYMBOL TABLE DEPENDENCIES 
FILES 
SEE ALSO 
DIAGNOSTICS 
WARNINGS 
BUGS 

DESCRIPTION 

Xdb, is a source level debugger for C, HP FORTRAN, and HP Pascal programs. It provides a con- 
trolled environment for their execution. 

Objectfile is an executable program file with one or more of its component modules compiled with 
debug option(s) turned on, (i.e. the -g flag). The support module /usr/lib/xdbend.o must be 
included as the last object file in the list of those linked, except for libraries included with the -1 
option to ld{l). (Some systems automate this; see the Hardware Dependencies section below.) 
The default for objectfile is a.out. 

Corefile is a core image from a failed execution of objectfile. The default for corefile is core. 

The options are: 

-d dir names an alternate directory where source files are located. They are searched in the 
order given. If a source file is not found in any alternate directory, the current direc- 
tory is searched last. 

-r file names a record file which is invoked immediately (for overwrite, not for append). See 
the section below entitled Record and Playback Commands for a description of this 
feature. 

-p file names a playback file which is invoked inmiediately. See the section below entitled 
Record and Playback Commands for a description of this feature. 
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There can only be one objectfile and one corefile per debugging session (activation of the 
debugger). The program (objectfiie) is not invoked as a child process until you give an appropri- 
ate command (see the Job Control Commands section below). The same program may be res- 
tarted, as different child processes, many times during one debugging session. 

This debugger is a complex, interactive tool with many synergistic and combinatoric features. 
What you can do with it is often limited only by your imagination. Remember, however, that the 
debugger is only a "window" on the world consisting mostly of the program being debugged and 
the system it nms on. If something puzzling happens, you may need to consult a manual which 
describes the program or the system, in order to understand the behavior. 

SMART TERMINAL SUPPORT 

This is the user interface supported on most HP terminals. The top of the screen is a "window" 
into the current source file, and the bottom of the screen is for XDB and user program input and 
output. Separating the two areas is a line (in inverse video) indicating the current file, procedure, 
and line number. Within the source file window, a ">" points to the current location (which may 
or may not be the location at which the user program is currently stopped). 

DUMB TERMINAL SUPPORT 

This is the user interface on non-HP or un-supported terminal types. This does not support win- 
dows. The source file is displayed one line at a time. With this interface some commands supply 
more information then the "window" interface to compensate. 

CONVENTIONS 

The debugger remembers the current file, current procedure, current line, and current data loca- 
tion. They are a function of what you have been viewing (not necessarily executing) most 
recently. Many commands use these current locations as defaults, and many commands set them 
as a side effect. It is important to keep this in mind when deciding what a command does in any 
particular situation. 

For example, if you stop in procedure "abc", then view procedure "def", then ask for the value of 
local variable "xyz", the debugger assimies that the variable belongs to procedure "def". 

Notational Conventions 

Most commands are of the form "command [location] [command-arguments] [command-list]". 
Numeric modifiers after commands can be any numeric expression. They need not be just simple 
numbers. A blank is required before any numeric option. Multiple commands on one line must 
be separated by ";". 

These are common modifiers and other specisd notations: 

(A I B I C) Any one of A or B or C is required. 

[A i B I C] Any one of A or B or C is optional. 

command-list A series of debugger commands, separated by ";", entered on the command line or 
saved with a breeikpoint or assertion. Semicolons are ignored (as commands) so 
they can be freely used as command separators. Commands may be grouped with 
"{}" for the "a", "b", "i" the abreviated {if} command, and "!" commands. In all 
other cases commemds inside "{}" are ignored. 

count The munber of repetitions specified for a command. 

depth A stack depth, as printed by the "t" command. The top procedure is at a depth of 

zero. A negative depth acts like a depth of zero. Stack depth usually means 
"exactly at the specified depth", not "the first instance at or above the specified 
depth". 

expr Any expression, but with limitations stated below. 
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file A file name. 

format A style for printing data. See the Data Viewing Commands section below for 

details. 

line A number that refers to a particular line in a file. 

location A particular line in a file (and its corresponding address in the user's program if 

there exists executable code for that line), location has the following general forms: 

line 

file[ : { line I #/o6e/ ) ] 

proc [ : proc [...]] [ : ( line I #/a6e 

number A specific, constant number (e.g. "9", not "4+5"). Floating point (real) numbers 

may be used any place a constant is allowed. 

proc A procedure (or function, or subroutine) name. 

var A variable name. 

Variable Name Conventions 

Variables are referenced exactly as they are named in your source file(s). Case sensitivity is con- 
trolled by the "Z" command. 

If you are interested in the value of some variable var, there are a number of ways of getting it, 
depending on where and what it is: 

var Search the stack for the most recent instance of the current procedure. If found, see if 

var is a parameter or local variable of that procedure. If not, search for a global vari- 
able named var. 

proczvar Search the stack for the most recent instance of proc. If found, see if it has a parameter 
or local variable named var, as before. 

procidepthivar 

Use the instance of proc that is at depth depth (exactly), instead of the most recent 
instance. This is very useful for debugging recursive procedures where there are multi- 
ple instances on the stack. 

:var Search for a global (not local) variable named var. 

Dot is shorthand for the last thing you viewed (see the Data Viewing Commands section 
below). It has the same size it did when you last viewed it. For examiple, if you look at 
a long as a char, then "." is considered to be one byte long. This is useful for treating 
things in unconventional ways, like changing the second highest byte of a long without 
changing the rest of the long. Dot may be treated like any other variable. 

NOTE: "." is the name of this magic location. If you use it, it is dereferenced like £iny 
other name. If you want the address of something that is, say, 30 bytes farther on in 
memory, do not say ".+30". That would take the contents of dot and add 30 to it. 
Instead, say "&.+30", which adds 30 to the address of dot. 

Special variables are names for things that are not normally directly accessible. Special variables 
include: 

$var The debugger has room in its own address space for a number of user-created special vari- 
ables. They are all of type long, and do not take on the type of any expression they are 
assigned to. Names are defined when they are first seen. For example, saying "p $xyz = 
3*4" creates special symbol "$xyz", and assigns to it the value 12. Special variables may 
be used just like any other variables. 
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$pc, $sp, $rO, etc. 

These are the names of the program coimter, the stack pointer, the Precision Architecture 
CPU registers, etc. To find out which names are available on your system, use the "1 r" 
(list registers) command. All registers act as type integer. 

$result 

This is used to reference the return value from the last procedure exit. Where possible, it 
takes on the type of the procedure. Sshort and $long are available as alternate ways of 
looking at Sresult. 

Ssignal 

This lets you see and modify the current child process signal number. 

$lang This lets you see and modify the current Isinguage (0 for C, 1 for FORTRAN, or 2 for Pas- 
cal). 

$line This lets you see and modify the current source line nmnber, which is also settable with a 
number of different commands. 

$inalloc 

This lets you see the current amount of memory (bytes) allocated at run-time for use by 
the debugger itself. 

$step This lets you see and modify the number of machine instructions the debugger will step 
while in a non-debuggable procedure before setting an up-level breakpoint and free- 
running to it. Setting it to a small value can improve debugger performance, at the risk 
of taking off free-running after missing the up-level break for some reason. 

To see all the special variables, including the predefined ones, use the "1 s" (list specials) com- 
mand. 

You can also look up code addresses with 

procline 

which searches for the given procedure name and line number (which must be an executable line 
within proc) and uses the code address of that line. Just referring to a procedure proc by name 
uses the code address of the entry point to that procedure. 

Expression Conventions 

Every expression has a value, even simple assignment statements, as in C. 

Integer constants may begin with "0" for octal or "Ox" or "OX" for hexadecimal. They are int if 
they fit in two bytes, long otherwise. If followed immediately by "I" or "L", they are forced to be 
of type long (this is useful on systems where int is two bytes). 

Floating point constants must be of the form digits.digit3[e\'E\d\Ti\L\\ \+\-]digits], for example, 
"1.0", "3.14e8", or "26.62D-31". One or more leading digits is required to avoid confusion with 
"." {dot). A decimal point and one or more following digits is required to avoid confusion for 
some command formats. If the exponent doesn't exactly fit the pattern shown, it is not taken as 
part of the number, but as separate token (s). The "d" and "D" exponent forms are allowed for 
compatibility with FORTRAN. The "1" and "L" exponent forms are allowed for compatibility 
with Pascal. However, all floating point constants are taken as doubles, regardless. 

Character constants must be entered in " and are treated as integers. C string constants must 
be entered in "" and are treated like "char *" (e.g. pointer to char). FORTRAN and Pascal 
strings may be enclosed in either " or "". Character and string constants may contain the stan- 
dard backslashed escapes understood by the C compiler and the echo{l) command, including 
"\b", "\f", "\n", "\r", "\t", "\\", "V", and "\nnn". However, "\<newline>" is not supported, 
neither in quotes nor at the end of a command line. 
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Expressions are composed of any combination of variables, constants, and C operators. The 
debugger knows what langauge the object file (i.e. a.out), is written in and will switch to the 
language specific operators used by that langauge. The user may also create a composite pro- 
gram, built from 2 or more of the supported langauges, and debug without regard to which parts 
are which. The global variable $lang will be set as necessary by the debugger, based on the sym- 
bol table data supplied with the object file. The Slang var can be set to "C", "FORTRAN" and 
"Pascal" or "Default". 

If there is no active child process and no corefile, you can only evaluate expressions containing 
constants. 

Expressions approximately follow the C rules of promotion, e.g. char, short, and int become 
long, and float becomes double. If either operand is a double, floating math is used. If either 
operand is unsigned, imsigned math is used. Otherwise, normal (integer) math is used. Results 
cire then cast to proper destination types for assignments. 

If a floating point number is used with an operator that doesn't normally permit it, the nimiber is 
cast to long and used that way. For example, the C binary operator "~" (bit invert) applied to 
the constant "3.14159" is the same as "~3". 

Note that "=" means "assign" except for Pascal; use "==" or ".EQ." for FORTRAN. In Pascal, 
"=" is a comparison operator; use ":=" for assignments. For example, if you invoke the 
debugger, then set "p Slang = Pascal", you must say "p Slang := C" to return to C. 

The special imary operator "Sin" (not to be confused with debugger local variables) evaluates to 1 
(true) if the operand is an address inside a debuggable procedure and $pc (the current child pro- 
cess program location) is also in that procedure, else it is (false). For example, tin main is 
true if the child process is stopped in main(). 

You can attempt to dereference any constant, variable, or expression result using the C "*" opera- 
tor. If the address is invalid, an error is given. 

Whenever an array variable is referenced without giving all its subscripts, the result is the address 
of the lowest element referenced. For example, consider an array declared as "x[5][6][7]" in C, 
"x(5,6,7)" in FORTRAN, or "x[1..5,2..6,3..7]" in Pascal. Referencing it simply as "x" is the same 
as just "x" in C, the address of "x(l,l,l)" in FORTRAN, or the address of "x[l,2,3]" in Pascal. 
Referencing it as "x[4]" is the same as "& (x[4][0][0])" in C, the address of "x(l,l,4)" in FOR- 
TRAN, or the address of "x[4,2,3]" in Pascal. 

If a not-fully-qualified array reference appears on the left side of an assignment, the value of the 
right-hand expression is stored into the element at the address specified. 

Except for C, array indices cire checked and must be within declared boimds. 

String constants are stored in a buffer in the file /usr/lib/xdbend.o, which you link with your pro- 
gram. The debugger starts storing strings at the beginning of this buffer, and moves along as 
more assignments are made. If the debugger reaches the end of the buffer, it goes back £ind reuses 
it from the beginning. In general this doesn't cause any problems. However, if you use very long 
strings, or if you assign a string constant to a global pointer, problems could arise. To fix them, 
you can edit and compile a personal copy of /usr/lib/xdbend.c to increase the size of the buffer. 
(Some systems don't support this; see the Hardware Dependencies section below.) 

Procedure Call Conventions 

Procedures may be invoked from the command line, even within expressions. For example: 

p xyz = Sabc * (3 + def (ghi - 1, jkl, "Hi Mom")) 

calls procedure "def" when its value is needed in the expression. 

Any breakpoints encountered during command line procedure invocation are handled as usual. 
However, the debugger has only one active command line at a time. If it stops in a called 
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procedure for any reason, the remainder (if any) of the old command line is tossed, with notice 
given. 

If you attempt to call a procedure when there is no active child process, one is started for you as if 
you gave a single-step command first. Unfortunately, this means that the data in corefile (if any) 
may disappear or be reinitialized. 

If you send signal SIGINT (e.g., hit the BREAK key) while in a called procedure, the debugger 
aborts the procedure call and returns to the previous stopping point (the start of the main pro- 
gram for a new process). 

You can call any procedure that is in your objectfile, even if it is not debuggable (was not com- 
piled with debug on). For example, assume that you reference "printf()" in your program, so the 
code for it is in your objectfile. Then you can enter on the conunand line: 

p printf ( "This works! %d %c\n", 9, /?/); 

If you wonder what procedures are available, do a list labels command ("1 1"). If you want to 
have some library routines available for debugging, but they aren't referenced anywhere in your 
code (so they aren't linked), you can modify a personal copy of /usr/lib/xdbend.c to reference 
them. (Some systems don't support this; see the Hardware Dependencies section below.) It is not 
necessary to have correct calls. For example, just "printf()" works fine, since you never execute 
the statements in xdbend.c. 

Note that procedure name " end " is declared in xdbend.c. 

COMMANDS 

The debugger has a large number of commands for viewing and manipulating the program being 
debugged. They are explained below, grouped by functional similarity. 

File Viewing Commands 

These commands may change the current viewing position, but they do not affect the next state- 
ment to be executed in the child process, if any. 

V View the source one window forward from the current source window. One or two lines 
from the previous window are preserved for context. If the "diunb" interface is in use 
only the next source line is displayed. 

V [location] 

View the source at the specified location, placing it in the center of the window. If the 
"dumb" interface is in use only the source line location is displayed. 

V [depth] 

View current procedure at depth in source window. Depth is an offset into the current 
procedure. If not specified the depth defaults to zero, which is where the program is 
currently stopped. 

L Display the file name, procedure name, line number, and the current source statement 

corresponding to the object code being executed or examined. Allows user to determine 
where they are in program under test, and this is useful in assertion and breakpoint 
commeind lists. 

-|-[/«nea] Move to lines (default one) lines after the current line. 

-[/mea] Move to lines (default one) lines before the current line. 

w [size] Set size of source viewing window. Normally set to 15 lines for a 24 line terminal. If the 
"dumb" interfsice is being used, this command prints size lines centered around the 
current location. 

/ [a<rmj/] Search forward through the current file, from the line after the current line, for string. 
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? [string] Search backward for string, from the hne before the current Une. 

Searches wrap around the end or beginning of the file, respectively. If string is not specified, the 
previous one is used. Wild cards and regular expressions are not supported; string must be literal. 

n Repeat the previous "/" or "?" command using the same string as previously. 

N The same as "n", but. the search goes in the opposite direction as specified by the previ- 

ous "/" or "?" command. 

Display Formats 

A format is of the form "[*]{count]formchar[size]" . 

"*" means "use alternate address map" (if maps are supported). 

Count is the number of times to apply the format style formchar. It must be a number. 

Size is the number of bytes to be formatted for each count, and overrides the default size for the 
format style. It must be a positive decimal number (except short hand notations, see below). Size 
is disallowed with those formchars where it makes no sense. 

For example, "p abc\4x2" prints, starting at the location of "abc", four two-byte numbers in hex- 
adecimal. 

The formats which print numbers allow an upper-case character to be used instead, for the same 
results as appending "I" (see below). For example, "O" prints in long octal. These formats, 
which are useful on systems where integer is shorter than long, are noted below. The following 
formats are available: 

n Print in the "normal" format, based on the type. Arrays of char and pointers to 

char are interpreted as strings, and structures are fully dumped. 

(d I D) Print in decimal (as integer or long). 

(u I U) Print in unsigned decimal (as integer or long). 

(o I O) Print in octal (as integer or long). 

(x I X) Print in hexadecimal (as integer or long). 

(b I B) Print a byte in decimal (either way). 

(c I C) Print a character (either way). 

(e I E) Print in "e" floating point notation (as float or double) (see prmi/(3S)). 

Remember that floating point constants are always doubles! 

(f I F) Print in "f" floating point notation (as float or double). 

(g I G) Print in "g" floating point notation (as float or double). 

a Print a string using expr as the address of the first byte. 

s Print a string using expr as the address of a pointer to the first byte. This is the 

same as saying "*ea:pr\a", except for arrays. 

t Show the type of expr (usually a variable or procedure name). For true pro- 

cedure types you must actually call the procedure, e.g. "def (2)\t". 

p Print the name of the procedure containing address expr. 

S Do a formatted dump of a structure (only with symbol tables which support it). 

Note that expr must be the address of a structure, not the address of a pointer to 
a structure. 

There are some short hand notations for size: 
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b 1 byte (char). 

8 2 bytes (short). 

1 4 bytes (long). 

These can be appended to formchar instead of a numeric size. For example, "abc\xb" prints one 
byte in hexadecimal. 

If you view an object with a size (explicitly or implicitly) less than or equal to the size of a long, 
the debugger changes the basetype to something appropriate for that size. This is so "." [dot] 
works correctly for assignments. For example, "abc\c2" sets the type of "." to short. One side 
effect is that if you look at a double using a float format, dot loses accuracy or has the wrong 
value. 

Data Viewing and Modification Commands 

p expr If expr does not look like anything else (such as a command), it is handled as if you had 
typed "p expr/n" (print expression in normal format), unless followed by ";" or "}", in 
which case nothing is printed. Note that modification of variables is done by using the 
assignment operator in the expression (ex. "p foo = 7" in C or FORTRAN, or "p foo := 
7" in Pascal). 

p expr\format 

Print the contents (value) of expr using format. For example, "abc\x" prints the contents 
of "abc" as an integer, in hexadecimal. 

p exprl format 

Print the address of expr using format. For example, "abc?o" prints the address of "abc" 
in octal. 

p -[[\] format] 

Back up to the preceding memory location (bcised on the size of the last thing displayed) . 
Use format if supplied, or the previous format if not. Note that no "\" is needed after the 

P +[[\] format] 

Go forward to the following memory location (based on the size of the last thing 
displayed). Use format if supplied, or the previous format if not. Note that no "\" is 
needed after the "+". 

1 \proc[.depth]] 

List all parameters and local variables of the current procedure (or of proc, if given, at the 
specified depth, if any). Data is displayed using "/n" format, except that all arrays and 
pointers are shown simply as addresses, and only the first word of any structure is shown. 

1 (a I b I d I z) 

List all assertions, breakpoints, directories (where to search for files), or zignals (signal 
actions). 

1 (f I g I 1 I m I p I r I s) [string] 

List all files (source files which built objectfile), global variables, labels (program entry 
points known to the linker), macros, procedure names, registers, or special variables 
(except registers). If string is present, only those things with the same initial characters 
are listed. 

Stack Viewing Commands 

t [depth] [ \format] 

Trace the stack for the first depth (default 20) levels. Use the format if specified. 
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T [depth] { Xformat] 

The same as "t", but local variables are also displayed, using "\n" format (except that all 
arrays and pointers are shown simply as siddresses, and structures as first words only) Use 
the format if specified. 

Job Control Commands 

The parent (debugger) and child {objectfile) processes take turns nuining. The debugger is only 
active while the child process is stopped due to a signal, including hitting a breakpoint, or ter- 
minated for whatever reason. 

r [arguments] 

Run a new child process with the given argument list (if any). The existing child pro- 
cess, if any, is terminated first. If no arguments are given, the ones used with the last 
"r" command are used again (none if "R" was used last). 

Arguments may contain "<" and ">" for redirecting standard input and standard out- 
put. ("<" does an open(2) of file descriptor for read-only: ">" does a creat{2) of file 
descriptor 1 with mode 0666). Arguments may contain shell variables ajid metacharac- 
ters, quote marks, or other special syntax. They cannot be enclosed in "{} " as with 
other commands, so "r" csmnot be safely saved with a breakpoint or assertion. 

R Run a new child process with no argument list. 

k Terminate (kill) the current child process, if it exists. 

c [location] 

Continue from breakpoint ignoring the signal. Set temporary breakpoint at specified 
location. 

C [location] 

Continue just like "c", but allow the signal (if any) to be received. This is fatal to the 
child process if it doesn't catch or ignore the signal! Set temporary breakpoint at 
specified location. 

s [count] Single step 1 (or count) statements. Successive carriage-returns repeat with a count of 
1. If count is less than one, the child process is not stepped. Note that the child process 
continues with the current signal, if any! (You can set "Ssignal = 0" to prevent this.) 

If you accidently step down into a procedure you don't care about, use the "bu" com- 
mand to set a temporary up-level breakpoint, and then continue using "c". 

S [count] 

Single step like "s", but treat procedure calls as single statements (don't follow them 
down). If a breakpoint is hit in such a procedure, or in one that it calls, its commands 
are executed. This is usually all right, but beware if there is a "c" command in that 
breakpoint's command list! 

The debugger has no knowledge about or control over child processes forked in turn by the pro- 
cess being debugged. Also, it gets very confused (leading to "Bad access" messages) if the process 
being debugged executes a different program via ea;ec(2). 

Child process output may be (and usually is) buffered. Hence it may not appear immediately 
after you step through an output statement such as printf{3S). It may not appear at all if you 
kill the process. 

Breakpoint Commands 

The debugger provides a number of commands for setting and deleting breakpoints. A breakpoint 
has three attributes associated with it: 

address All the commands which set a breakpoint are simply alternate ways to specify the break- 
point address. The breakpoint is then encountered whenever address is about to be 
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executed, regardless of the path taken to get there. Only one breakpoint at a time (of 
any type or count) may be set at a given address. Setting a new breakpoint at address 
replaces the old one, if any. 

count The number of times the breakpoint is encountered prior to recognition. If count is posi- 
tive, the breakpoint is "permanent", and count decrements with each encounter. Each 
time count goes to zero, the breakpoint is recognized and count is reset to one (so it stays 
there until explicitly set to a different value by a "c" or "C" command). 

If count is negative, the breakpoint is "temporary", and count increments with each 
encounter. Once count goes to zero, the breakpoint is recognized, then deleted. 

A count of zero is used internally by the debugger and means that the breakpoint is 
deleted when the child process next stops for any reason, whether it hit that breakpoint 
or not. Commands saved with such breakpoints are ignored. Normally you never see 
these sorts of breakpoints. 

Note that count is set to either -1 (temporary) or 1 (permanent) for any new breakpoint. 
It can then be modified only by the "be" command. 

commands 

Actions to be taken upon recognition of a breakpoint before waiting for command input. 
These are separated by ";" and may be enclosed in "{}" to delimit the list saved with the 
breakpoint from other commands on the same line. If the first character is anything other 
than "{", or if the matching "}" is missing, the rest of the line is saved with the break- 
point. 

Saved commands are not parsed until the breakpoint is recognized. If commands are nil then, 
after recognition of the breakpoint, the debugger just waits for command input. 

The debugger has only one active command line at a time. When it begins to execute breakpoint 
commands, the remainder (if any) of the old command line is tossed, with notice given. 

Here are the breakpoint commands: 

lb List all breakpoints in the format "num: count: nnn proc: In: contents", followed by 

" {commands}" , e.g.: 

1: count: 1 (temporary) sortall: 12: abc -l-= 1; 

{t;i\D} 
2: count: 5 fixit: 29: def = abc » 4; 

{Q;if *argv == -1 {"Oops"} {c}} 

The leftmost number is an index number for use with the "d" (delete) command. 

b [location] [count] [commands] 

Set a permanent breakpoint at the current location (or at location). Set the count 
number of times through breakpoint. When the breakpoint is hit, commands are exe- 
cuted. If there are none, the debugger pauses for command input. If immediate continua- 
tion is desired, finish the command list with "c" (see breakpoint 2 in the example above). 

db [number] 

Delete breakpoint number number. If number is absent, delete the bresikpoint at the 
current line, if any. If there is none, the debugger executes a "lb" command instead. 

db* 

bp [commands] 

Set permanent breakpoints at the beginning (first executable line) of every debuggable 
procedure. When any procedure breakpoint is hit, commands are executed. 



Hewlett-Packard Company - 10 - December 1986 



XDB(l) XDB(l) 

Series 800 Only 



It is permissible to set other permanent or temporary breakpoints at the same locations as 
these "procedure " breakpoints. If a procedure and non- procedure breakpoint are both hit 
at the same location, the non-procedure breakpoint has priority; the effect is the same as 
if there were no procedure breakpoint. It is not possible to alter the "count" of a pro- 
cedure breakpoint. Procedure breakpoints must be activated and deleted as a group; it is 
not possible to set or delete individual ones. 

Procedure breakpoints are useful for procedure stepping and tracing. For example, the 
command 

bp Q;t l;c 

sets up procedure tracing by printing the current procedure at each breakpoint. 

dp Delete all "procedure" breakpoints. All breakpoints set by commands other than "bp" 

will remain set. 

bb [depth] [\count] [commands] 

Set a breakpoint at the beginning (first executable line) of the procedure at the given 
stack depth. If depth is not specified, it uses the current procedure, which might not be 
the same as the one at depth zero. 

bx [depth] [\count] [commands] 

Set a breakpoint at the exit (last executable line) of the procedure at the given stack 
depth. If depth is not specified, it uses the current procedure, which might not be the 
same as the one at depth zero. The breakpoint is set at a point such that all returns of 
any kind go through it. 

bu [depth] [\count] [commands] 

Set an up- level breakpoint. The breakpoint is set immediately after the return to the pro- 
cedure at the specified stack depth (default one, not zero). A depth of zero means 
"current location", e.g. "bu 0" is a way to set a temporary breakpoint at the current 
value of $pc. 

bt [{depth I proc)] [\count] [commands] 

Trace current procedure (or procedure at depth, or proc). This command sets break- 
points at both the entrance and exit of a procedure. By default, the entry breakpoint 
commands are "Q;2t;c", which shows the top two procedures on the stack and continues. 
The exit breakpoint is always set to execute "Q;SresuIt/n;c", which prints the 
procedure's return value and continues. 

If depth is given, proc must be absent or it is taken as part of commands. If depth is 
missing but proc is specified, the named procedure is traced. If both depth and proc are 
omitted, the current procedure is traced, which might not be the same as the one at depth 
zero. 

If commands are present, they are used for the entrance breakpoint, instead of the default 
shown above. 

ba address [\count] [commands] 

Set a breakpoint at the given code address. Note that address can be the name of a pro- 
cedure or an expression containing such a name. Of course, if the child process is stopped 
in a non-debuggable procedure, or in prologue code (before the first executable line of a 
procedure), things may seem a Uttle strange. 

be number count 

Set count of breakpoint number, to count. 

The next few commands, while not strictly part of the breakpoint group, are used almost 
exclusively as arguments to breakpoints (or assertions). 
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if [expr] {commands} [{commands}] 

If expr evaluates to a non-zero value, the first group of commands (the first "{}" block) is 
executed, else it (and the following "{", if any) is skipped. In general, all other "{}" 
blocks are always ignored (skipped), except when given as an argument to an "a", "b", or 
"!" command. The "if" command is nestable, and may be abbreviated to "i". 

Q If the "quiet" command appears as the first command in a breakpoint's command list, the 

normal announcement of "proc: line: text" is not made. This allows quiet checks of vari- 
ables, etc. to be made without cluttering up the screen with unwanted output. The "Q" 
command is ignored if it appears anywhere else. 

"any string you like" 

Print the given string, which may have the standard backslashed character escapes in it, 
including "\n" for newline. This command is useful for labelling output from breakpoint 
commands. 

Assertion Control Commands 

Assertions are lists of commands that are executed before every statement. This means that, if 
there is even one active assertion, the program is single stepped at the machine instruction level. 
In other words, it runs very slowly. The primary use for assertions is tracking down nasty bugs, 
such as when someone corrupts a global variable. Some examples follow the command descrip- 
tions. 

Each assertion is individually active or suspended, plus there is an overall assertions mode. If any 
assertion is added or activated, or if all assertions become suspended, the global mode follows suit. 

a commands 

Create a new assertion with the given command list, which is not parsed until it's exe- 
cuted. As with breakpoints, the command list may be enclosed in "{}" to delimit it from 
other commands on the same line. Do an "1 a" command to list all current assertions 
and the overall mode. 

aa number 

Activate assertion number. 

da number 

Delete assertion number. 

da "■ Delete all assertions, currently in effect. 

sa number 

Suspend assertion number. 

ta Toggle the overall state of the assertions mechanism between active and suspended. 

X [mode] 

Force an exit from assertions mode. If mode is absent, or if it evaluates to zero, exit 
immediately. Otherwise, finish executing the current assertion first. If any assertion exe- 
cutes an "x" command, the child process stops and the assertion doing the "x" is 
identified. 

The debugger has only one active command line at a time. When it begins to execute assertion 
commands, the remainder (if any) of the old command line is tossed, with notice given. 

Certain commands ("r", "R", "c", "C", "s", "S", and "k") are not allowed while assertions are 
running. They must appear after the "x", if at all. 

A useful assertion might be: 

a L 
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This just traces execution a line at a time until "something" happens (e.g., you hit the BREAK 
key). 

Another exsimple: 

a L; if(xyz > (def - 9) * 10) {ta; x 1; c} {p abc -= 10} 

This assertion prints the line just executed, then checks the condition. If it is false, "abc" is 
decremented by 10. If it is true, assertions are suspended, assertion mode is exited, and the pro- 
gram continues at normal speed. Without the number after the "x" command, the "c" conunand 
is not executed. 

Another example: 

a if ( abc != $abc) {p $abc = abc;p abc\d; if (abc > 9) {x} } 

This command sets up an assertion to report the changing value of some global variable ("abc"), 
and stop if it ever exceeds some value. It uses a debugger local variable ("$abc") to keep track of 
the old value of "abc". 

Signal Control Commands 

The debugger catches all signals bound for the child process before the child process sees them. 
(This is a function of the ptrace(2) mechcmism.) For many signals, this is a reasonable thing to 
do. Most processes are not set up to handle segmentation errors, etc. However, some processes 
do quite a bit with signals and the constant need to continue from a signal catch can be tedious. 

z [signal] [i][r][8][Q] 

Maintains the "zignal" (signal) handling table. Signal is a valid signal number (the 
default is the current signal). The options (which must be all one word) toggle the state 
of the appropriate flag: ignore, report, or stop. If "Q" is present, the new state of the 
signal is not printed. 

Do a "Iz" command to list the current handling of all signals. Note that just "z signal" with no 
options tells you the state of the selected signal. 

For example, assuming a start up state of (don't ignore, don't report, don't stop), the command 
"z 14 sr" sets the alarm clock signal (at least for HP-UX) to stop (but still don't ignore) and 
report that it occurred. Doing "z 14 sr" again toggles the flags back to the original state. 

When the child process stops or terminates on a signal it is always reported, except for the break- 
point signal when the breakpoint commands start with "Q". 

When the debugger ignores a signal, the "C" command then does not know about it, £md the sig- 
nal will not be passed to the child process. The signal is never ignored when the child process ter- 
minates, only when it stops. 

Record and Playback Commands 

The debugger supports a record-and-playback feature to help recreate program states and to 
record all debugger output. It is particularly useful for bugs requiring long setups. Note: The file 
name can not be "t" , "f", or "c" , or begin with a "@". 

The commands are: 

>file Set or change recordfile to file and turn recording on. This rewrites file from the start. 
Only commands are recorded to this file. 

»fHe This is the same, but appends to file instead of overwriting. 

>@file 

»@filSet or change record-all file to file, for overwriting or appending. The record-ail file may 
be opened or closed independently of (in parallel with) the recordfile. All debugger stan- 
dard output is copied to the record-all file, including prompts, commands entered, and 
command output. However, child process output is not captured. 
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>(t I f I c) Turn recording on ("t") or off ('T'), or close the recording file ("c"). When 
recording is resumed, it appends after commands recorded earlier. In this con- 
text, ">>" is the same as ">". 

>@(t I f I c) Turn record-all on, off, or close the record-all file. In this context, ">>@" is the 
same as ">@". 

tr [@] Toggle recording [record-all]; if ON turn it OFF, if OFF turn it ON. 

> Tell the current recording status. ">>" does the same thing. 

>@ Tell the current record-all status. ">>@" does the same thing. 

<fUe Start playback from file. 

«file Start playback from file, using the single-step feature of playback. Each command line 
from the playback file is presented before it is executed. A simple menu lets you execute 
("<cr>") or skip ("S") the line, execute more than one line ("<num>"), continue ("C") 
or quit ("Q") single stepping, or ask for help ("?"). 

Only command lines read from the keyboard or a playback file are recorded in the recordfile. For 
example, if recording is turned on in an assertion, it doesn't "take effect" until assertion execution 
stops. 

Command lines beginning with ">", "<", or "I" are not copied to the current recordfile (but they 
are copied to the record-all file). You can override this by beginning such lines with blanks. 

NOTE: The debugger can of course be invoked with standard input, standard output, and/or 
standard error redirected, independent of record and playback. If the debugger encounters an end 
of file while standard input is redirected from anything other than a terminal, it prints a message 
to standard output and exits, returning zero. 

Macro Facility 

def name [replacement-text] 

Defines name to be the macro whose value is replacement-text. Name may be any string 
of letters or digits. Replacement-text may be any string of letters, digits, blanks, tabs, or 
other printing characters, with the restriction that it may not be continued onto a new 
line. This command may not be abreviated as 1 char. It must be "def" or "define" only. 

undef name 

Remove the macro definition from name so that name no longer exists as a replacement 
string macro. As a special case "*" may be entered for number to undefine all macros. 
This command may not be abreviated as 1 char. It must be "imdef" or "undefine" only. 

tm Toggle the state of the macro substitution mechanism between active and suspended. 
When macro substitution is suspended, the currently defined macros continue to exist, 
but they are not replaced in the command-line by their definitions. Additional macros 
may still be defined while macro substitution is suspened. 

Miscellaneous Commands 

sm Suspends the "more" facility so that debugger output is no longer pagenated. This is 
most useful when breakpoints or assertions will be printing a great deal of information to 
the screen, and you do not want the debugger to keep waiting for you to hit the space 
bar. 

am Activates the "more" facility so that debugger output is pagenated. 

td Toggles dissassembly mode. When in dissassembly mode, the source window displays the 

code in assembly language, and the single step command steps assembly instruction at a 
time. The display consists of: the source line number, the address in hex, the address in 
the form of nearest label plus offset, and the assembly instruction. If the debugger is 
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the form of nearest label plus offset, and the assembly instruction. If the debugger is 
already in split screen mode, then the td command changes the level of single stepping, 
but has no change on the display other then the mode displayed in the line seperarating 
the source statements from the assembly instructions. 

ts Toggles split screen mode. When in split screen mode, the source window is half source 

code and half assembly instructions. In split screen mode, the td command still toggles 
the debugger between symbolic (or source) mode and assembly mode, as indicated by the 
line seperating the source from the assembly. The only difference is whether single step- 
ping is at the source statement or assembly instruction level. 

<c arriage-return > 

An empty line or a "~" command causes the debugger to repeat the last command, if pos- 
sible, with an appropriate increment, if any. Repeatable commands are those which print 
a line, print a window of lines, print a data value, single step, and single step over pro- 
cedures. Note that <carriage-return> is saved in a record file as a "~" command, to dis- 
tinguish from "D. 

! [command-line] 

This shell escape invokes a shell program. If command-line is present, it is executed via 
system(3). Otherwise, the environment variable SHELL gives the name of the shell pro- 
gram to invoke with a — i option, also using system{3S). If SHELL is not found, the 
debugger executes "/bin/sh i". In any case, the debugger then waits for the shell or 
command-line to complete. 

As with breakpoiiils, coTririiand-iine may be enclosed in "{}" to delimit it from other 
(debugger) commands on the same line. For example, 

b 14 {!{date};c}; t; 1 a 

sets a breakpoint at line 14 that calls date{l), then continues; then (after setting the 
breakpoint), the debugger does a stack trace, then lists assertions. 

# [text] Flags this text as a comment to be echoed to the command window. The # must appear 
as the first non-blank character on the line and the remainder of the line is treated as a 
comment. It is also written to the currently open record file. 

D dirs Adds dirs to the list of additional directory search paths for source files. This command is 
equivalent to the command-line option -d. 

f [" printf-style-format"] 

Set address printing format, using printf{3S) format specifications (not debugger format 
styles). Only the first 19 characters are used. If there is no argument, the format is set 
to a system-dependent default. All addresses are assumed to be of type long, so you 
should handle all four bytes to get something meaningful. 

g line I if^ label 

Go to an address in the procedure on the stack at depth zero (not necessarily the same as 
the current procedure). This changes the program counter so line or the line i^label 
appears on is the next line to be executed. 

h 

help Print the debugger help file (conunand summary) using more(l). 

I Print information (inquire) about the state of the debugger. 

q Quit the debugger. To be sure you don't lose a valuable environment, this command 

requests confirmation. 

tc Toggle case sensitivity in searches. This affects everything: File names, procedure names, 

variables, and string searches! 
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SYMBOL TABLE OEPENDENCIES 

When you try to display a variable which is a FORTRAN format label, a Pascal file-of-text, or a 
Pascal set, with no display format or with normal format ("\n"), the value is shown as "{format- 
label}", "{file-of-text}", or "{set}", respectively. You can use other formats, such as "\x", to 
display the contents of such variables. 

Procedures in FORTRAN and Pascal may have alias names in addition to normal names. 
Aliases are shown by the "1 p" (list procedures) command. They can be used in place of 
the normal name, as desired. 

The procedure name "^MAIN " is used as the alias name for the main program (main 
procedure) in all supported languages. Do not use it for any debuggable procedures. 

FORTRAN ENTRY points are flagged "ENTRY" by the "1 p" command. 

When a compiler does not know array dimensions, such as for some C and FORTRAN 
array parameters, it uses 0:MAXINT or 1:MAXINT, as appropriate. The "\t" format 
shows such cases with "[]" (no bounds specified), and subscripts from (or 1) to MAXINT 
are allowed in expressions. 

Even though the symbol table supports C structure, union, and enumeration tags, C 
typedefs, and Pascal types, the debugger does not know how to search for them, even for 
the "\t" format. They are "invisible". 

Some variables are indirect, so a child process must exist in order for the debugger to 
know their addresses. When there is no child process, the address of any such variable is 
shown as Oxff"fffffe. 

The optional pattern given with the "1 g" (list globals) command must be an exact 
match, not just a leading pattern. 

The string cache (see the -S option) defaults to 1Kbyte in size. This cache holds data 
read from the Value Table. 

Symbol names in the Value Table are never preceded by underscores, so the debugger 
never bothers to search for names of that form. The only time a prefixed underscore is 
expected is when searching the Linker Symbol Table for names of non-debuggable pro- 
cedures. 



Default objectfile to debug. 

Default corefile to debug. 

Text file listed by the "help" command. 

Text file which explains debugger error and warning messages. 

Object file to link with all debuggable programs. 

Source file for xdbend.o. 



FILES 

a.out 

core 

/usr/lib/xdb.help 

/ usr/lib/xdb. error 

/usr/lib/xdbend.o 

/usr/lib/xdbend.c 

SEE ALSO 

cc(l), echo(l), ld(l), more(l), creat(2), exec(2), fork(2), open(2), printf(3S), system(3S), a.out(4). 

On some systems any of the following may exist: adb(l), fc(l), pc(l), sdb(l), ptrace(2), core(5), 
symtab(5), user(5). 

DIAGNOSTICS 

Most errors cause a reasonably accurate message to be given. Normal debugger exits return zero 
and error exits return one. All debugger output goes to standard output except error messages 
given just before non-zero exits, which go to standard error. 

Debugger errors are preceded by "panic: ", while user errors are not. If any error occurs during 
initialization, the debugger then prints "cannot continue" and quits. If any error happens after 
initialization, the debugger attempts to reset itself to an idle state, waiting for command input. If 
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any error occurs while executing a procedure call from the command line, the context is reset to 
that of the normal program. 

Child process (program) errors result in signals which are communicated to the debugger via the 
ptrace{2) mechanism. If a program error occurs while executing a procedure call from the com- 
mand line, it is handled like £iny other error (i.e. you can investigate the called procedure). To 
recover from this, or to abort a procedure call from the command line, type DEL, BREAK, 'C, or 
whatever your interrupt character is. 

For more information, see the text file /usr/lih/xdh. errors. 

WARNINGS 

Code that is not debuggable or does not have a corresponding source file is dealt with in a half- 
hearted manner. The debugger shows "unknown" for unknown file £ind procedure names, cannot 
show code locations or interpret parameter lists, etc. However, the linker symbol table provides 
procedure names for most procedures, even if not debuggable. The main procedure (main pro- 
gram) must be debuggable and have a corresponding source file. 

On some systems, if the debugger is run on a shared objectfile you cannot set breakpoints. (This 
may only apply if someone else is also executing the program.) This may be indicated by the 
error "Bad access" when you attempt to start a child process. If another person starts running 
objectfile while you are debugging, they and you may have some interesting interactions. 

If the address given to a "ba" command is not a code address in the child process, strange results 
or errors may ensue. 

If you set the address printing format to something prtntf('6S) doesn't like, you may get an error 
(usually memory fault) each time you try to print an address, until you fix the format with 
another "f" command. 

Do not use the "z" command to manipulate the SIGTRAP signal. If you change its state you had 
better know what you are doing or be a very good sport! 

If you single step or run with assertions through a call to longjmp{3C), the child process will 
probably take off' free-running as the debugger sets but never hits an up-level breakpoint. 

Do not modify any file while the debugger has it open. If you do, the debugger gets confused and 
may display garbage. 

Although the debugger tries to do things reasonably, it is possible to confuse the recording 
mechanism. Be careful about trying to playback from a file currently open for recording, or vice 
versa; strange things can happen. 

Many compilers only issue source line symbols at the end of each logical statement or physical 
line, whichever is greater. This means that, if you are in the habit of saying "a = 0; b = 1;" on 
one line, there is no way to put a breakpoint after the assignment to "a." but before the assign- 
ment to "b". 

Some statements do not emit code where you would expect it. For example, assume: 

99: for (i = 0; i < 9; i-|-|-) { 
100: xyz (i); 

101: } 

A breakpoint placed on line 99 will be hit only once in some cases. The code for incrementing is 
placed at line 101. Each compiler is a little different; you must get used to what your particular 
compiler does. A good way of finding out is to use single stepping to see in what order the source 
lines are executed. 

The output of some program generators, such as yacc{l), have compiler line number directives in 
them that can confuse the debugger. It expects source line entries in the symbol table to appear 
in sorted order. Removal of line directives fixes the problem, but makes it more difficult to find 
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error locations in the original source file. The following script, run after j/acc(l) and before cc(l), 
conuncnts out line number changes in C programss: 

sed "/# *line/s/".*$/\/*&*\//" y.tab.c >temp.c 

In general, line number directives (or compiler options) are only safe so long as they never set the 
number backwards. 



BUGS 



The C operators "++ ", " — ' , and "?:" are not available. The debugger always understands all 
the other C operators, except "sizeof", if the default language is FORTRAN or Pascal. User 
should use Ssizeof which works in any language. 

For FORTRAN, only the additional operators ".NE.", ".EQ.", ".LT.", ".LE.", ".GT.", and 
".GE." are supported. 

For Pascal, only the operators ":=", "<>", , "'." (as in "x'.y"), "and", "or", "not", "div", 
"mod", "addr", and "sizeof" are added. 

There is no support for FORTRAN complex variables, except as a series of two separate floats or 
doubles. 

The debugger doesn't understand C type casts, such as (int) or (char). 

The C operators "icSc" and "11" aren't short circuit evaluated as in the compiler. All parts of 
expressions involving them are evaluated, with any side-effects, even if it's not necessary. 

The debugger doesn't understand C pointer arithmetic. "*(a-l-n)" is not the same as "a[n]" unless 
"a" has an element size of 1. 

There is no support for C local variables declared in nested blocks, nor for any local overriding a 
parameter with the same name. When looking up a local by name, parameters come first, then 
locals in the order of the "}"s of the blocks in which they are declared. When listing all locals, 
they are shown in the same order. When there is a name overlap, the address or data shown is 
that of the first variable with that name. 

There is no support for Pascal intermediate variables. To reference a variable local to £in enclos- 
ing procedure, you must specify the procedure name and stack depth in the usual way 
{proc:.depth:.var). 

XDB does not support identically-named procedures (legal in Pascal if the procedures are in 
different scopes). XDB will always use the first procedure with the given name. 

There is no support for Pascal packed arrays where the element size is not a whole number of 
bytes. Any reference into such an array may produce garbage or a bad access. 

Pascal WITH statements are not understood. To access any variable you must specify the com- 
plete "path" to it. 

The debugger supports call-by-reference only for known parameters of known (debuggable) pro- 
cedures. If the object to pass lives in the child process, you can fake such a call by passing "&c 
object", i.e. the address of the object. 

Array parameters are always passed to command-line procedure calls by address. This is correct 
except for Pascal call-by-value parameters. Structure parameters are passed by address or value, 
as appropriate, but only a maximum of eight bytes is passed, which can totally confuse the called 
procedure. FORTRAN string markers are never passed correctly. Only the first number of a com- 
plex pair is passed as a parameter. Functions which return complex numbers are are not called 
correctly; insufficient stack space is allocated for the return area, which can lead to overwriting 
the parameter values. 

Assignments into objects greater than four bytes in size, from debugger special variables, result in 
errors or invalid results. 



Hewlett-Packard Company - 18 - December 1986 



XDB(l) XDB(l) 

Series 800 Only 



Case-insensitive searches are done in a crude way which equates some non-letters with other non- 
letters. For example, "[" and "{" are equal, as are "@" and "" ". 

Command lines longer than 1024 bytes are broken into pieces of that size. This may be relevant 
if you run the debugger with playback or with input redirected from a file. 
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NAME 

yacc - yet another compiier-compiler 

SYNOPSIS 

yacc [ -vdlt ] [ —N<secondary><n> . . . ] grammar 

DESCRIPTION 

Yacc converts a context-free grammar into a set of tables for a simple automaton which executes 
an LR(1) parsing algorithm. The grammar may be ambiguous; specified precedence rules are used 
to break ambiguities. 

The output file, y.tab.c, must be compiled by the C compiler to produce a program yyparse. 
This program must be loaded with the lexical analyzer program, yylex, as well as main and yyer- 
ror, an error handling routine. These routines must be supplied by the user; lex{l) is useful for 
creating lexical analyzers usable by yacc. 

If the -V flag is given, the file y.output is prepared, which contains a description of the parsing 
tables and a report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y.tab.h is generated with the #define statements that associate the 
j/acc-assigned "token codes" with the user-declared "token names". This allows source files other 
than y.tab.c to access the token codes. 

If the -1 flag is given, the code produced in y.tab.c will not contain any #line constructs. Gen- 
erally, this should only be used after y.tab.c has compiled successfully, since the #line directives 
allow the C compiler to give error messages that refer to the yacc source file rather than the 
y.tab.c file. This option is useful, however, for symbolic debugging, since some symbolic 
debuggers may be confused by line numbers that are not in order. 

The -N<secondary><n> option allows the sizes of certain internal yacc tables to be re.set. 
Secondary is one of the letters from the setfamspneclw} and specifies the table; n is the 
new size. Tables that can be reset by using secondary letters are as follows: 

a a-array size; default is 12000. 

m mem array size; default is 12000. 

s number of states; default is 1000. 

p number of productions; default is 800. 

n number of non- terminals; default is 600. 

e temp-space size; default is 1250. 

c name-space size; default is 5000. 

1 look-ahead set table size; default is 650. 

w working set table size; default is 650. 

If an array overflows, yacc issues a fatal error message including a suggestion of which table to 
reset. For example: 

too many states, try -Ns option 

Runtime debugging code is always generated in y.tab.c under conditional compilation control. 
By default, this code is not included when y.tab.c is compiled. However, when yacc's -t option 
is used, this debugging code will be compiled by default. Independent of whether the -t option 
was used, the runtime debugging code is imder the control of YYDEBUG, a pre-processor sym- 
bol. If YYDEBUG has a non-zero value, then the debugging code is included. If its value is zero, 
then the code will not be included. The size and execution time of a program produced without 
the runtime debugging code will be smaller and slightly faster. 
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ERRORS 

The number of reduce-reduce and shift-reduce conflicts is reported on the standard error output; a 
more detailed report is foimd in the y.output file. Similarly, if some niles are not reachable from 
the start symbol, this is also reported. 

FILES 

y.output 

y.tab.c 

y.tab.h defines for token names 

yacc.tmp, 

yacc.acts, yacc.debug temporary files 

/usr/lib/yaccpar parser prototype for C programs 

WARNINGS 

Because file names are fixed, at most one yacc process can be active in a given directory at a time. 

The maximum number of terminal symbols is fixed at 2000 and cannot be reset using the -N 
option. 

SEE ALSO 

lex(l), malloc(3X). 

LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, Jime, 1974. 

YACC - Yet Another Compiler Compiler in HP-UX Concepts and Tutorials. 

INTERNATIONAL SUPPORT 

8-bit data sind filenames. 
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NAME 

intro - introduction to glossary section 

DESCRIPTION 

This section contains a glossary of common HP-UX terms. References to other HP-UX docmnen- 
tation are included as appropriate. References to entities such as wait{2), 3h{l), or /open(3S) refer 
to entries in the other sections of this manual. References to items in italics but having no 
parenthetical suffixes refer to other entries in this glossary. Finally, any references to italicized 
manuals refer to separate manuals that are included with your system or are available for pur- 
chase. 

SEE ALSO 

The introduction to this manual. 



The glossary section of the Documentation and Terminology Guide. 



Hewlett-Packard Company - 1 - Version B.l, October 1986 



GLOSSARY (9) 



HP-UX 



GLOSSARY (9) 



("dot-ok") The format of an unlinked object file. See a.out. 

absolute path name 

A path name beginning with a slash (/). It indicates that the file's location is 
given relative to the root directory (/), and that the search begins there. 

access Access to system resources is governed by three values: the effective user ID, the 

effective group ID, and the group access list. 

access groups The group access list is an additional set of group ID's used only in determining 
resource accessibility. Access checks are performed as described below in file 
access permissions. 

address In the context of peripheral devices, a set of values which specify the location of 

an I/O device to the computer. The exact details of the formation of an address 
differ between systems. On the Series 300 and 500, the address is composed of 
up to four elements: the select code, bus address, unit number (id), and volume 
number (id). 

affiliation See terminal affiliation. 

a.out The format of executable object code files on HP-UX. The format is machine- 

dependent, and is described in the a.out{4) for each implementation. Object 
code which is as yet unlinked is in the same format, but is referred to as a .o 
("dot-oh") file. A.out is also the default output file name used by the linker, 
W(l). 

archive A file which is made up of the contents of other files (such as a group of object 

(i.e. .o) files to be used by the linker, W(l)). An archive file is created and main- 
tained by ar(l), or by similar programs, such as <ar(l) or cpio{i). An archive is 
often called a library. 

ASCII An acronym for American Standard Code for Information Interchange. It con- 

sists of a set of characters including letters, numerals, punctuation, and control 
characters, each of which is represented internally by 7 bits (0 - 127). 

asynchronous I/O 

An I/O operation for which the user process need not wait for completion before 
continuing execution. 

backup The process of making a copy of all or part of the file system in order to preserve 

it should a system crash occur (usually due to a power failure, hardware error, 
etc.). This is a highly reconunended practice. 

block (1) The fundamental imit of information HP-UX uses for access and storage allo- 

cation on a mass storage medium. The size of a block varies between implemen- 
tations, and between file systems. In order to present a more uniform interface 
to the user, most system calls and utilities use "block" to mean 512 bytes, 
independent of the actual block size of the medium. This is the meaning of 
"block" unless otherwise specified in the manual entry. 

(2) On media such as 9 track tape which write variable length strings of data, 
the size of those strings. Block is often used to distinguish from record with a 
block containing several records, with the number of records being the 
blockingiajctOT. 

block special file A special file associated with a mass storage device (such as a hard disk or a CS- 
80 tape cartridge drive) that transfers data in imits of blocks. Block special files 
may be mounted. 



Hewlett-Packard Company 



- 1 



Version B.l, October 1986 



GLOSSARY (9) 



HP-UX 



GLOSSARY (9) 



boot or boot-up The process of loading, initializing, and running an operating system. 

boot area On the Series 300, a portion of a mass storage medium (block zero) on which the 

volume header and a small "bootstrap" program used in booting the operating 
system reside. The boot area is reserved exclusively for use by HP-UX. 

On the Series 500, the portion of an SDF mass storage medium which contains 
an operating system. 

boot ROM On the Series 300, a program residing in ROM (Read Only Memory) that exe- 

cutes each time the computer is powered-up. The function of the boot ROM is 
to nm tests on the computer's hardware, find all devices accessible through the 
computer, and' then load either a specified operating system or the first operating 
system found according to a specific search algorithm. 

The Series 500 computers have a program that is identical in function, but differs 
in implementation. See system loader. 

bus address A number which makes up part of the 6iddress HP-UX uses to "find" a particular 

device. The bus address is determined by a switch setting on a peripheral device 
which allows the computer to distinguish between two devices connected to the 
same interface. A bus address is sometimes called a "device address". 

CS/80 or CS-80 A family of mass storage devices that commimicate via the CS/80 (Command 
Set '80) command set. Examples are the HP 7908, HP 7911, HP 7912, and HP 
7914 disk/tape drives. 

character special file 

A special file associated with devices which transfer data character-by-character. 
Examples are printers, terminals, nine-track magnetic tapes, and disks accessed 
in "raw" mode (see raw disk). 

child process A new process created by a pre-existing process via the fork{2) system call. The 
new process is thereafter known to the pre-existing process as its child process. 
The pre-existing process is the parent process of the new process. See parent 
process £ind fork. 

command A stEind-alone imit of executable code (a program), or a file containing a list of 

other programs to execute in order (a shell script). In HP-UX, commands are 
executed through a command interpreter called a shell, often sh{l). Arguments 
following the command name are passed on to the command program. You can 
write your own commands, either as executable programs, or as shell scripts 
(written in the shell programming language). 

command interpreter 

A program which reads lines of text from standard input (typed at the keyboard 
or redirected from a file), and interprets them as requests to execute other pro- 
grams. A command interpreter for HP-UX is called a shell. See sh(l) and 
csh{l). 



control character 



A member of a character set which produces action in a device other than print- 
ing or displaying a character. In the ASCII character set, control characters are 
those in the range through 31, and 127. Control characters can be generated 
by holding down [CRTL], [CONTROL], or [CNTL] (depending on what the con- 
trol key is labeled on your terminal) and pressing a character key (as you would 
use SHIFT). These two-key sequences are often written as ctrl-d, for example, or 
'D, where " stands for the control key. Both representations assume that the 
control key is held down while the second key is pressed. 
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crash 



current directory 



The unexpected shutdown of a program or system. If the operating system 
crashes, this is a "system crash", and requires the system to be re-booted. 

See working directory. 

current working directory 

See workirig directory. 

daemon A process which runs m the backgroimd, and which is usually immune to termi- 

nation instructions from a terminal. Its purpose is to perform various schedul- 
ing, clean-up, and maintenance jobs. Lpached{lM) is an example of a daemon 
that exists to perform these functions for line printer jobs queued by ip(l). An 
example of a permanent daemon (i.e. it never should die) is cron(lM). 

data encryption A method for encoding information in order to protect sensitive or proprietary 
data. For example, all users' passwords are automatically encrypted by HP-UX. 
The encryption method used by HP-UX converts ASCII text into a base-64 
representation using the alphabet ., /, 0-9, A-Z, a-z. See passwd{4) for the 
numerical equivalents associated with this alphabet. 

default search path 

The sequence of directory prefixes that sh{l), time{l), and other HP-UX com- 
mands apply in searching for a file known by an incomplete path name (i.e. a 
path name not beginning with a slash, /). It is defined by the environment vari- 
able PATH (see enwron(5)). Login{l) sets PATH equal to :/bin:/u8r/bin, 
which means that your working directory is the first directory searched, followed 
by /bin, followed by /usr/bin. You can redefine the search path by modifying 
the value of PATH. This is usually done in /etc/profile, and/or in the 
.profile file found in your home directory. 

delta A term used in the Source Code Control System (SCCS) to describe a unit of 

one or more textual changes to an SCCS file. Each time you edit an SCCS file, 
the changes you make to the file are stored separately as a delta. Then, usmg 
the get{l) command, you can specify which deltas are to be applied to or 
excluded from the SCCS file, thus yielding a particular version of the file. Con- 
trast this with the vi or ed editor, which incorporates your changes into the file 
immediately, prohibiting you from obtaining a previous version of that file. See 
SCCS, SCCS file. 

demon See daemon. 

device file See special file. 

directory A file which provides the mapping between the names of files and their contents. 

For every file name contained in a directory, that directory contains a pointer to 
the file's inode called a link. A file may have several links appearing anywhere 
on the same file system. Each user is free to create (using mkdir{\)) as many 
directories as needed, providing that the parent directory of the new directory 
gives the permission to do so. Once a directory has been created, it is ready to 
contain ordinary files and other directories. An HP-UX directory is named and 
behaves exactly like an ordinary file, with one exception: no user (includmg the 
super-user) is allowed to write data on the directory itself; this privilege is 
reserved for the HP-UX operating system. 

By convention, a directory contains at least two links, . and .., referred to as dot 
and dot-dot respectively. Dot refers to the directory itself and dot-dot refers to 
its parent directory. For purposes of deletion, a directory containing only . and 
.. is considered empty. 
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effective group ID 

Every process has an effective group ID that is used to determine file access per- 
missions. A process's effective group ID is determined by the file (command) 
that process is executing. If that file's set-groupnlD bit is set (located in the 
mode of the file, see mode), the process's effective group ID is set equal to the 
file's group ID. This makes the process appear to belong to the file's group, 
perhaps enabling the process to access files which must be accessed in order for 
the progrEim to execute successfully. If the file's set-group-ID bit is not set, the 
process's effective group ID is inherited from the process's psirent. The setting of 
the process's effective group ID lasts only as long as the program is being exe- 
cuted, after which the process's effective group ID is set equal to its real group 
ID. See group, real group ID, and set-group-ID bit. 

effective user ID A process has an effective user ID that is used to determine file access permis- 
sions (and other permissions with respect to system calls, if the effective user ID 
is 0, which means super- user). A process's effective user ID is determined by the 
file (command) that process is executing. If that file's set-user-ID bit is set 
(located in the mode of the file, see mode), the process's effective user ID is set 
equal to the file's user ID. This makes the process appear to be the file's owner, 
enabling the process to access files which must be accessed in order for the pro- 
gram to execute successfully. (Many HP-UX commands which are owned by 
root, such as mkdir and mail, have their set-user-ID bit set so other users can 
execute these commands.) If the file's set-user-ID bit is not set, the process's 
effective user ID is inherited from that process's parent. The setting of the 
process's effective user ID lasts only as long as the program is being executed, 
after which the process's effective user ID is set equal to its real user ID. See 
real user ID and set-user-ID bit. 

environment The set of defined shell variables (some of which are PATH, TERM, SHELL, 
EXINIT, HOME) which define the conditions under which your commands run. 
These conditions can include your terminal characteristics, your home directory, 
and your default search path. Each shell variable setting in the current process 
is passed on to £ill child processes that are created, provided that each shell vari- 
able setting has been exported via the export command (see sh{l)). Unexported 
shell variable settings are meaningful only to the current process, and any child 
processes created are given the default settings given certain shell variables in 
/etc/profile and/or $HOME/.profile. 

end-of-file (1) the data returned when attempting to read past the logical end of a file via 

stdio{ZS) routines. In this case end-of-file is not properly a character. 

(2) The character [CTRL]-[D]. 

(3) A character defined by stty{l) or ioctl{2) (see termio{7)) to act as end-of-file 
on your terminal. Usually this is [CTRL]-[D]. 

(4) The indication (as the function result) which indicates end of data when 
using read{2). 

file An HP-UX file is simply a stream of bytes representing ASCII text (text files) or 

binary data (such as executable code). Thus, directories, ordinary files, special 
files, etc., can all be considered files. Every file must have a file name (see file 
name) which enables the user (and many of the HP-UX commands) to reference 
the contents of the file. The size of a file is exactly the mmiber of bytes the file 
contains. The system imposes no particular structure on the contents of a file 
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(although some programs do). Files may be accessed serially or randomly 
(indexed by byte offset). The interpretation of file contents and structure is up 
to the programs that access the file. 

file access permissions 

Every file in the file system has a set of access permissions. These permissions are 
used in determining whether a process may perform a requested operation on the 
file (such as opening a file for writing). Access permissions are established at the 
time a file is created. They may be changed at some later time through the 
chmod{2) call. 

File access is determined according to whether a file may be read, written, or 
executed. Directory files use the execute permission to control whether or not 
the directory may be searched. 

File access permissions are interpreted by the system as they apply to three 
diff^erent classes of users: the owner of the file, those users in the file's group, any- 
one else. Every file has an independent set of access permissions for each of these 
classes. When an access check is made, the system decides if permission should 
be granted by checking the access information applicable to the caller. 

Read, write, and execute/search permissions on a file are granted to a process if: 

The process's effective user ID is super-user. 

The process's effective user ID matches the user ID of the owner of the 
file and the appropriate access bit of the "owner" portion (0700) of the 
file mode is set. 

The process's effective user ID does not match the user ID of the owner 
of the file, and either the process's effective group ID matches the group 
ID of the file, or the group ID of the file is in the process's group access 
list, and the appropriate access bit of the "group" portion (070) of the 
file mode is set. 

The process's effective user ID does not match the user ID of the owner 
of the file, and the process's effective group ID does not match the group 
ID of the file, and the group ID of the file is not in the process's group 
access list, and the appropriate access bit of the "other" portion (07) of 
the file mode is set. 

Otherwise, the corresponding permissions are dehied. 

file descriptor A small integer identifier that is used to refer to a file that has been opened for 
reading and/or writing, and is an index into the user's table of open files. The 
opened file must be identified by its file descriptor when using system calls to 
read or write the file. 

The value of a file descriptor has a range from to a system defined maximum. 
For systems at HP-UX STANDARD and above, the minimum value for this 
number is 60. For systems below HP-UX STANDARD the minimum value is 20. 
No file descriptor may have a value outside the range 0-59 or 0-19, depending on 
the implementation. 

A file descriptor is obtained through system calls such as open{2), creat{2), 
dup{2), fcntl{2) or pipe{2). The file descriptor is used as an argument by calls 
such as Tead(2), write{2), ioctl{2), and close{2). 

file name A string of up to 14 characters that is used to refer to the contents of an ordi- 

nary file, special file, or directory. These characters may be any ASCII character 
except ASCII values (null) and 47 (slash - /). Note that it is generally unwise 
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to use *, ?, [, !, or ] as part of file names becaiise of the special meaning the shell 
attaches to these characters (see 3/1(1)). It is also not wise to begin a file name 
with -, +, or =, because some programs assmne that these characters indicate 
that a command argiunent follows. Although permitted, it is advisable to avoid 
the use of characters that do not have a printable graphic on the hardware you 
conunonly use, or are likely to confuse the hardware. 

file pointer A data element, obtained through any of the /open( 3S) standard I/O library rou- 

tines that "points to" (refers to) a file opened for reading and/or writing, and 
which keeps track of where the next I/O operation will take place in the file (in 
the form of a byte offset relative to the beginning of the file). After obtaining 
the file pointer, it must thereafter be used to refer to the open file when using 
any of the standard I/O library routines. (See a<d»o(3S) for a list of these rou- 
tines.) 

file system The supporting data structures, HP-UX directory structure, and associated files 

that reside on one or more mass storage volumes. Refer to the System Adminis- 
trator Manual supplied with your system for details concerning file system imple- 
mentation and maintenance. 

filter A conamand which reads data from the standard input, performs a transforma- 

tion on the data, and writes it to the standard output. 

fork An HP-UX system call (/orfc(2)) which, when invoked by an existing process, 

causes a new process to be created. The new process is called the child process; 
the existing process is called the parent process. The child process is created by 
making an exact copy of the parent process. The parent and child processes are 
able to identify themselves by the value returned by their corresponding fork call 
(see fork{2) for details). 

group An association of zero or more users who must all be permitted to access the 

same set of files. The members of a group are defined in the file /etc/passwd 
via a numerical group ID (users with identical group IDs are members of the 
same group). An ASCII group name is associated with each group ID in the file 
/etc/group (the members of each group can be listed in /etc/group, also, but 
this information is purely for user benefit, and is of little use to the system). A 
group name is associated with every file in the file system, and the mode of each 
file contains a set of permission bits which apply only to groups of which the file 
owner is a member. Thus, if you are a member of the group name associated 
with the file (as determined by the information in /etc/group and 
/etc/passwd), and if the appropriate permissions are given to your group in 
the file's mode, you may access the file. See real group ID, effective group ID, 
privelged group and set-group-ID bit. 

group access list The group access list is an additional set of group ID's used only in determining 
resource accessibility. Access checks are performed as described in file access 
permissions. 

hierarchical directory 

A directory (or file system) structure in which each directory may contain other 
directories as well as files. 

home directory The directory name given by the value of the shell variable HOME. When you 
first log in, login{l) automatically sets HOME equal to your login directory (see 
login directory). You may change its value at any time, however. This is usu- 
ally done in the .profile file contained in your login directory. Setting HOME in 
no way affects your login directory, but simply gives you a convenient way of 
referring to what should be your most commonly-used directory. 
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host name An ASCII string of at most 8 characters (of which only 6 are supported by al! 

the various manufactuer's UNIX operatmg systems) which uniquely identifies an 
HP-UX system on a uucp network. The host name for your system may be 
viewed and/or set with the hostname{l) command. Systems without a defined 
host name are described as "unknown" on the uucp network. Do not confuse a 
host name with a node name, which is a string that imiquely identifies an HP- 
UX system on a Local Area Network (LAN). Although your host and node 
names may be identical, they £ire set and used by totally different software. See 
node name. 

inode Each ordinary or special file, or directory has associated with it an inode. The 

inode contains, among other things, the file's size, protection mask, the number 
of links, and pointers to the disk blocks where the file's contents can be found. 
Each connection between an inode and its entry in one or more directories is 
called a link. 

image The current state of your computer (or your portion of the computer, on a 

multi-user system) during the execution of a command. Often thought of as a 
"snapshot" of the state of the machine at any particular moment during execu- 
tion. 

init A special process (the initialization process) usually with a process ID of 1. It is 

the ancestor of every other process in the system and is used to start login 
processes. 

interleave factor A nmnber which determines the order in which sectors on a mass storage 
medium are accessed. It can be optimized to make data acquisition more 
efiicient. 

Internal Terminal Emulator (ITE) 

The "device driver" code contained in the HP-UX kernel and associated with the 
computer's built-in keyboard and display or a particular keyboard and display 
connected to the computer, depending on the Series and Model of your HP-UX 
computer. See system console and the System Adminstrator Manual supplied 
with your system for details. 

interrupt signal The signal sent by SIGINT (see signal{2)). This signal generally terminates 
whatever program you are running. The key which sends this signal can be 
redefined with ioctl{2) or stty{l) (see termio{7)). It is often the ASCII DEL 
(rubout) character (the pEL] key) or the [BREAK] key. [CONTROL]-[C] is 
often used instead. 



intrinsic 



See system call. 



I/O redirection A mechanism provided by the HP-UX shell for changing the source of data for 
standard input and/or the destination of data for standard output and standard 
error. See sh(l). 

job control Job control allows users to selectively stop (suspend) the execution of processes 

and continue (resume) their execution at a later point. 

The user employs this facility via the interactive interface jointly supplied by the 
system tty driver and csh{l). The tty driver recognizes a user-defined suspend 
character which causes all current foreground processes to stop and the user's job 
control shell to resume. The job control shell provides commands which continue 
stopped processes in either the foreground or backgroimd. The tty driver will 
also stop a background process when it attempts to read from or write to the 
users termmal. This allows the user to finish or suspend their foreground task 
without interruption emd continue the stopped background process at a more 
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convenient time. 

See csh{l), stgnal{2), and termio{7). 

kernel The HP-UX operating system. The kernel is the executable code responsible for 

managing the computer's resources, such as allocating memory, creating 
processes, and scheduling programs for execution. The kernel resides in RAM 
(Random Access Memory) whenever HP-UX is running. 

library An archive file containing a set of subroutines and variables which may be 

accessed by user programs. For example, /lib/libc.a is a library containing all 
functions of section (2), and all functions of section (3) marked (3C) and (3S), in 
the HP-UX Reference. Similarly, /lib/libm.a is a library containing all func- 
tions in section (3) marked (3M) in the HP-UX Reference. See intro{3). 

LIF An acronym for Logical Interchange Format. A standard format for mass 

storage implemented on many Hewlett-Packard computers to aid in media tran- 
sportability. The lif*{l) commands are used to perform various functions using 
LIF. 

link A directory entry for any type of file. The information constituting a link 

includes the name of the file, and where the contents of that file may be found on 
a mass storage medium. One physical file may have several links to it. If the 
links appear in different directories, the file may or may not have the same name 
in each. If the links appear in one directory, however, each link must have a 
unique name in that directory. Multiple links to directories are not allowed 
(except for the super-user). See cp(l), link{l), link{2), and unlink{2). Also, to 
prepare a program for execution, see linker. 

linker The linker combines one or more object programs into one program, searches 

libraries to resolve user program references, and builds an executable file in a. out 
format. This executable file is ready to be executed through the program loader, 
exec{2). The linker is invoked with the ld{l) command. The linker is often 
called a link editor. 

logical block size The smallest unit of memory which can be allocated on a Series 500 SDF 
volume; a multiple of the physical sector size. This value is set at system initiali- 
zation time; see init. 

login The process of gaining access to HP-UX. This consists of successful execution of 

the login sequence defined by login{l) which varies depending on the system 
configuration. It includes providing a login name and possibly one or more pass- 
words. 

login directory The directory in which you are placed immediately after you log in. This direc- 
tory is defined for each user in the file /etc/passwd. The shell variable HOME 
is set automatically to your login directory by login{l) immediately after you log 
in. See home directory. 

magic number The first word of an a.ou<-format or archive file. This word contains the system 
ID, which states what machine (hardware) the file will run on, and the file type 
(executable, shareable executable, archive, etc.). 

major number A number used exclusively to create special files that enable I/O to/from specific 
devices. This number indicates which device driver to use for the device. Refer 
to mknod{2) and the System Administrator Manual supplied with your system 
for details. 

message queue identifier 

A message queue identifier (msqid) is a unique positive integer created by a 
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msgget{2) system call. Each msqid has a message queue and a data structure 
£issociated with it. The data structure is referred to as msqid— ds and contains 
the following members: 

struct ipc_perm msg perm; /* operation permission struct */ 

ushort msg_qnum; /* nimiber of msgs on q */ 

ushort msg__qbytes; /* max niunber of bytes on q */ 

ushort msg_lspid; /* pid of last msgsnd operation */ 

ushort msg Irpid; /* pid of last msgrcv operation */ 

time t msg_^time; /* last msgsnd time */ 

time_t msg__rtime; /+ last msgrcv time */ 

time_t msg_ctime; /* last change time */ 

/♦ Times measured in sees since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 
Message queue identifiers may be created using stdipc{3C). 

Msg perm is a ipc_perm structure that specifies the message operation per- 
mission (see below). This structure includes the following members: 
ushort cuid; /* creator user id */ 
ushort cgid; /* creator group id */ 
ushort uid; /* user id */ 
ushort gid; /* group id */ 
ushort mode; /* r/w permission */ 
M8g_qnum is the number of messages currently on the queue. Msg_qbytes 
is the maximmn nimiber of bytes allowed on the queue. Msg Ispid is the pro- 
cess id of the last process that performed a msgsnd operation. Msg Irpid is 

the process id of the last process that performed a msgrcv operation. 

Msg stime is the time of the last msgsnd operation, msg rtime is the time of 

the last msgrcv operation, and msg—ctime is the time of the last msgctl{2) 
operation that changed a member of the above structure. 

message operation permissions 

In the msgop{2) and msgctl{2) system call descriptions, the permission required 
for an operation is given as "{token}", where "token" is the type of permission 
needed interpreted as follows: 

00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions on a msqid are granted to a process if one or more 
of the following are true: 

The process's effective user ID is super-user. 

The process's eifective user ID matches m8g_perm.[c]uid in the data 
structure associated with msqid and the appropriate bit of the "user" por- 
tion (0600) of msg_perm.mode is set. 

The process's effective user ID does not match m8g_perm.[c]uid and 

either the process's effective group ID matches msg perm.[<^]sid or one of 

m[8g_perm.[c)gid is in the process's group access list and the appropriate 
bit of the "group" portion (060) of msg— perm.mode is set. 

The process's effective user ID does not match m8g_perm.[c]uid and the 

process's effective group ID does not match msg perm, [c] gid and neither 

of msg perm, [c] gid is in the process's group access list and the 
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appropriate bit of the "other" portion (06) of msg—perm.niode is set. 
Otherwise, the corresponding permissions are denied. 

metacharacter A character which has special meaning to the HP-UX shell. The set of meta- 
characters includes: *, ?, !,[,],<,>,;, I, ', \ ", and &. Refer to sh{l) for the 
meaning associated with each. 

minor number A number used exclusively to create special files that enable I/O to/from specific 
devices. This number is passed to the device driver and is used to select which 
device in a family of devices is to be used, and possibly some operational modes. 
The exact format and meaning of the minor number is both system and driver 
dependent. Refer to the System Administrator Manual supplied with your sys- 
tem for details. See address. 

On the Series 300 and 500, for HP-IB devices, this number indicates the HP-IB 
address, select code, and the unit and/or volimie numbers. 

mode A 16-bit word associated with every file in the file system, stored in the inode. 

The least-significant 12 bits of this word determine the read, write, and execute 
permissions for the file owner, file group, and all others, and contain the set- 
user-ID, set-group-ID, and "sticky" (save text image after execution) bits. The 
least-significant 12 bits are settable by the chmod{l) command if you are the 
file's owner or the super-user. The sticky bit can only be set by the super-user. 
These 12 bits are sometimes referred to as permission bits. The most-significant 
4 bits specify the file type for the associated file and are set as the result of 

mountable file system 

A removable blocked file system contained on some mass storage medium with 
its own root directory and £in independent hierarchy of directories and files. See 
block special file and mount{lM). 

multi-user state The condition of the HP-UX operating system in which terminals in addition to 
the system console are allowing communication between the system and its users. 
By default, the Series 300 multi-user state is state 2, and the Series 500 multi- 
user state is state 1. Do not confuse the multi-user system with the multi-user 
state. A multi-user system is a system which may have more than one user 
actively communicating with the system when it is in the multi-user state. The 
multi-user state removes the single-user restriction imposed by the single-user 
state. See single-user state. See inittab{4). 

new-line The character with an ASCII v£ilue of 10 (line-feed) used to separate lines of 

characters. It is represented by \n in the C language and in vjirious utilities. 
The terminal driver (see tty{7)) normally interprets the carriage-retum/line-feed 
sequence sent by a terminal as a single new-line character. 

node name A string of up to 31 characters, not including control characters or spaces, that 

imiquely identifies a node on a Local Area Network (LAN). The node name for 
each system is set by the npowerup command, which is one of the commands 
supplied with the optional LAN/9000 product. Do not confuse a node name 
with a host name, which is a string that uniquely identifies an HP-UX system on 
a uucp network. Your node and host names can be identical, but they £ire used 
and set by totally different software. See host name, LAN/9000 User's Guide, 
and LAN/9000 Node Manager's Guide. 

ordinary file A type of HP-UX file containing ASCII text (e.g. program source), binary data 
(e.g. executable code), etc. Ordinary files can be created by the user through 
I/O redirection, editors, or HP-UX commfmds. 
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orphan proceas Whenever a parent process terminates for any reason and Ica'v 

more child processes that are still active, those child processes are called orphan 
processes. /nif(lM) inherits (becomes the effective parent of) all orphan 
processes. 

OSF An acronym for Operating System File. An OSF resides in the SDF boot area 

on a Series 500 system, and contains all or part of an operating system. 

owner The owner of a file is usually the creator of that file. However, the ownership of 

a file can be changed by the super-user or the current owner with the cho'wn{l) 
command or the chown{2) system call. The file owner is able to do whatever he 
wants with his files, including remove them, copy them, move them, change their 
contents, etc. He is also able to change the files' modes. 

parent directory A directory's parent directory is the directory one level above it in the file hierar- 
chy. All directories except the root directory (/) have one (and only one) parent 
directory. The parent directory is sometimes referred to as the superior direc- 
tory. 

parent process Whenever a new process is created by a currently-existing process (via /orA:(2)), 
the currently-existing process is said to be the parent process of the newly- 
created process. Every process has exactly one parent process (except the init 
process, see init), but each process can create several new processes with the 
/orA;(2) system call. The parent process ID of any process is the process ID of its 
creator. 

password A string of ASCII characters used to verify the identity of a user. Passwords can 

be associated with users and groups. If a user has a password, it is automatically 
encrypted and entered in the second field of that user's line in the /etc/passwd 
file. A user may create or change a password for himself with the passwd{l) 
command. 

path name (sometimes written as one word, pathname). A sequence of directory names 

separated by slashes, and ending with any file neime. All file names except the 
last in the sequence must be directories. If a path name begins with a slash (/), 
it is an absolute path name (see absolute path name); otherwise it is a relative 
path name (see relative path name). A path name defines the path to be fol- 
lowed through the hierarchical file system in order to find a pwirticular file. 

More precisely, a path name is a null-terminated character string constructed as 
follows: 

<path-name>::=<file-name>|<path-prefix><file-name> I / 

<path-prefix>::=<rtprefix>|/<rtprefix> 

<rtprefix>::=<dimame>/|<rtprefix><dirname>/ 

where <file-name> is a string of 1 to 14 characters other than the ASCII slash 
and null, and <dirname> is a string of 1 to 14 characters (other than the ASCII 
slash and null) that names a directory. 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is treated as if it named 
a non-existent file. 

permission bits The nine least-significant bits of a file's mode. These bits determine read, write, 
and execute permissions for the file's owner, the file's group, and all others. 
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pipe 



privileged groups 



prod 
process 



process group 



process group ID 



An inter-process I/O channel used to pass data between two processes. It is 
commonly used by the shell to transfer data from the standard output of one 
process to the standard input of another. On a command line, a pipe is signaled 
by a vertical bar (I). The output from the command (s) on the left of the verti- 
cal bar is channeled directly into the standard input of the comm£md(s) on the 
right. 

I 

A privileged group is a group which has had a setprivgrp (see getprivgrp{2)) 
operation performed on it giving it access to some system calls otherwise reserved 
for the super-user. 

See init. 

An invocation of a program, or the execution of an image. No command can be 
executed without a process in which it can execute. Alternately, a process can- 
not exist without a command or image in some stage of execution. Several 
processes can all be running the same program, but each may have different data 
and be in different stages of execution. 

An association of one or more processes is called a process group. A process's 
membership in a particular process group is established by a numerical process 
group ID. Each process can belong to only one process group. Every process 
group has a process group leader. See process group ID and process group 
leader. 

) 

A positive integer in the range 1 - 30000 associated with every active process, 
which establishes that process's membership with a particular process group. All 
members of a process group have the same process group ID. A process group 
ID is always the process ID of the process group leader. This grouping permits 
the signalling of related processes. See kill{2), process group, and process group 
leader. 

process group leader 

A process group leader is a process whose process group ID and process ID are 
equal. A process becomes a process group leader through the setpgrp{2) system 
call. All processes created by the process group leader become members of that 
process group. All processes created by the tnit process (see init) are process 
group leaders. For example, when you log in on the system, the shell you receive 
to interpret your commands is a process group leader, and all subsequent 
process's created by your shell are members of your shell's process group. See 
process group ID and process group. 

process ID Each active process in the system is uniquely identified by a positive integer 

called a process ID. The range of this ID is from 1 to 30000. This permits the 
selective sending of signals to processes with kill{l), kill{2), or signal{2). The 
process ID of any user process is available with the ps(l) command. If a back- 
ground process is created, the shell reports its process ID to you when execution 
has begim. 

program A sequence of instructions to the computer in the form of binary code (resulting 

from the compilation and assembly of program source). 

prompt The character(s) displayed by the shell on the display indicating that the system 

is ready for a command. The prompt is usually a dollar sign ($) for ordinary 
users and a pound sign (#) for the super-user, but the user can re-define it to be 
any string by setting the shell variable PSl in his .profile file. 
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quit signal The signal sent by SIGOUIT. See 8ignal(2). The quit signal is generated by 

typing the character defined by the teletype handler as your quit signal. (See 
sttyil), ioctl{2), and termio{7).) The default is the ASCII FS character (ASCII 
value 28, generated by typing [CONTROL]- [\].) This signal usually causes a 
running program to terminate £ind generates a file containing the "core image" of 
the terminated process. The core image is useful for debugging purposes. (Some 
systems do not support core images, and on those systems no such file is gen- 
erated.) 

raw disk The name given to a disk for which there exists a character special file which 

allows direct transmission between the disk and the user's read or write buffer. 
A single read or write call results in exactly one I/O call. 

real group ID A positive integer which is assigned to every user on the system. The association 
of a user and his real group ID is done in the file /etc/passwd. The modifier 
"real" is used because a user can also have an effective group ID (see effective 
group ID). The real group ID can then be mapped to a group name in the file 
/etc/group, although it need not be. Thus, every user is a member of some 
group (which may be nameless) , even if that group has only one member. 

Every time a process creates a child process (via /orA;(2)), that process has a real 
group ID equal to the parent process's real group ID. This is useful for deter- 
mining file access privileges within the process. 

real user ID A positive integer which is assigned to every user on the system. A real user ID 
is assigned to every valid login name in the file /etc/passwd. The modifier 
"real" is used because a user can also have an effective user ID (see effective user 
ID). 

Every time a process creates a child process (via fork{2)), that process has a real 
user ID equal to the parent process's real user ID. This is useful for determining 
file access privileges within the process. 

regular expression 

A string of zero or more characters which selects text. The characters contained 
in the string may all be literal, which means that the regular expression matches 
itself only, or one or more of the characters may be a metacharacter, which 
means that a single regular expression could match several literal strings. Regu- 
lar expressions are most often encountered in text editors (such as ed(l), ex{l), 
or w(l)), where searches are performed for a specific piece of text, or in com- 
mands that were created to search for a particular string in a file (most notably 
grep{l)). Regular expressions are also encoimtered in the shell, 5/i(l), especially 
when referencing file names on command lines. See ed{l). 

relative path name 

A path name that does not begin with a slash. It indicates that a file's location 
is given relative to your current working directory, and that the search begins 
there (instead of at the root directory). An example is dirl/file2, which 
searches for the directory dirl in your current working directory. Dirl is then 
searched for the file file2. 

root directory (1) The highest level directory of the hierarchical file system, from which all 
other files branch. In HP-UX, the "/" character refers to the root directory. 
The root directory is the only directory in the file system that is its own parent 
directory. 

(2) Each process has associated with it a concept of a root directory for the 
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purpose of resolving path name searches for those paths beginning with "/". A 
process's root directory need not be the root directory of the root file system, and 
can be chsinged by the chroot{l) command or chroot{2) system CEill. Such a 
directory appears to the process involved to have .. pointing to itself. 

root volume The mass storage volume which contains the boot area (which contains the HP- 
UX kernel) and the root directory of the HP-UX file system. 

saved group ID Every process has a saved group ID which retains the process's effective group 
ID from the last successful ezec(2), or from the last super-user call to setgid. 
Setgid permits a process to set its effective group ID to this remembered value. 
Consequently, a process which executes a program with the set-group-ID bit set 
and with a group ID of 5 (for example) can set its effective group ID to 5 any 
time imtil the program terminates. See eiec(2), setuid{2), saved user ID, 
effective group ID, and set-group-ID bit. 

saved process group ID 

Every process has a saved process group ID that retains the process's group ID 
from the last successful exec{2). See setpgrp{2), termio(7), and process group ID. 

saved user ID Every process has a saved user ID which retains the process's effective user ID 
from the last successful exec{2), or from the last super-user call to setuid{2). 
Setuid{2) permits a process to set its effective user ID to this remembered value. 
Consequently, a process which executes a program with the set-user-ID bit set 
and with an owner ID of 5 (for example) can set its effective user ID to 5 any 
time until the program terminates. See exec{2), seiuid{2), saved group ID, 
effective user ID, and set-user-ID bit. 

sees An acronym for Source Code Control System. The Source Code Control System 

is a set of HP-UX commands which enable you to store changes to an SCCS file 
as separate "units" (called deltas). These units, each of which contains one or 
more textual changes to the file, can then be applied to or excluded from the 
SCCS file to obtain different versions of the file. The commands that laake up 
SCCS are admin{l), cdc{l), delta{l), get{l), prs{l), rmdel{l), sact{l), sccsdiff{l), 
unget{l), j;a/(l), and what{l). See delta, SCCS file. 

SCCS file An ordinary text file which has been modified so that the Source Code Control 

System (SCCS) may be used with it. This modification is done automatically by 
the admin{l) conunand. See SCCS, delta. 

SDF An acronym for Structured Directory Format. SDF is implemented on the Series 

500 computers only, and provides tree-structured access to files through the root 
directory of the voliune. 



secondary prompt 



select code 



One or more characters that the shell prints on the display, indicating that more 
input is needed. This prompt is much less often encountered than the shell's pri- 
mary prompt (see prompt). When it occurs, it is usually caused by an omitted 
right quote on a string (which confuses the shell), or when you enter a shell pro- 
gr£unming language control-flow construct (such as a for construct) from the 
command line. By default, the shell's secondarj' prompt is the greater-than sign 
(>), but you can re-define it by setting the shell variable PS2 appropriately in 
your .profile file. 

On the Series 300 and 500 part of an address used for devices. A ntunber deter- 
mined by a setting on the interface card to which a peripheral device is con- 
nected, or by the particular I/O slot in which the I/O card resides. Multiple 
peripherals connected to the same interface card share the same select code. 
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semaphore identifier 

A semaphore identifier (semid) is a unique positive integer created by a 
semget{2) system call. Each semid has a set of semaphores and a data structure 
associated with it. The data structure is referred to as semid— da and contains 
the following members: 

struct ilx;_perm sem perm; /* operation permission struct */ 

ushort sem nsems; /* number of sems in set */ 

time t sem otime; /* last operation time */ 

time t sem ctime; /* last change time ♦/ 

/* Times measured in sees since */ 
/* 00:00:00 GMT, Jan. 1, 1970 ♦/ 
Semaphore identifiers may be created using stdipc(^C). 

Sem perm is a ipc_perm structure that specifies the semaphore operation per- 
mission (see below). This structure includes the following members: 

ushort cuid; /* creator user id */ 

ushort cgid; /* creator group id */ 

ushort uid; /* user id */ 

ushort gid; /* group id ♦/ 

ushort mode; /♦ r/a permission ♦/ 

The value of sem nsems is equal to the nimiber of semaphores in the set. 

Each semaphore in the set is referenced by a positive integer referred to as a 

sem— num. Sem num values run sequentially from to the value of sem nsems 

minus 1. Sem otime is the time of the last semop{2) operation, £ind 

sem ctime is the time of the last semctl{2) operation that changed a member 

of the above structure. 

A semaphore is a data structure that contains the following members: 

ushort semval; /* semaphore value */ 

short sempid; /* pid of last operation */ 

ushort semncnt; /* # awaiting semval > cval */ 
ushort semzcnt; /* # awaiting semval = */ 
Semval is a non-negative integer. Sempid is equal to the process ID of the last 
process that performed a semaphore operation on this semaphore. Semncnt is a 
count of the mmiber of processes that are currently suspended awaiting this 
semaphore's semval to become greater than its current value. Semzcnt is a 
count of the number of processes that are currently suspended awaiting this 
semaphore's semval to become zero. 

semaphore operation permissions 

In the semop{2) and semctl{2) system call descriptions, the permission required 
for an operation is given as "{token}", where "token" is the type of permission 
needed interpreted as follows: 

00400 Read by user 

00200 Alter by user 

00060 Read, Alter by group 

00006 Read, Alter by others 

Read and Alter permissions on a semid are granted to a process if one or more of 
the following are true: 

The process's effective user ID is super-user. 
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The process's effective user ID matches sem perin.[c]uid in the data 

structure associated with semid find the appropriate bit of the "user" por- 
tion (0600) of sem perm.mode is set. 

The process's effective user ID does not match sem perin.[c]uid and the 

appropriate bit of the "group" portion (060) of sem perm.mode is set. 

The process's effective user ID does not match sem perm.[c]uid and the 

process's effective group ID does not match sem perm.[c]gid and neither 

of sem perm.[c]gid is in the process's group access list and the appropri- 
ate bit of the "other" portion (06) of sem perm.mode is set. 

Otherwise, the corresponding permissions are denied. 

set-group-ID bit A single bit in the mode of every file in the file system. If a file is executed 
whose set-group-ID bit is set, the effective group ID of the process which exe- 
cuted the file is set equal to the real group ID of the owner of the file. See 
effective group ID, group, and real group ID. 

set-user-ID bit A single bit in the mode of every file in the file system. If a file is executed 
whose set-user-ID bit is set, the effective user ID of the process which executed 
the file is set equal to the re£il user ID of the owner of the file. See effective user 
ID and real user ID. 

allured memuTy idejiiijier 

A shared memory identifier (shmid) is a unique positive integer created by a 
shmget{2) system call. Each shmid has a segment of memory (referred to as a 
shared memory segment) and a data structure associated with it. The data 
structure is referred to as shmid— ds and contains the following members: 

struct ipc_perm shm perm; /* operation permission struct */ 



int 


shm segsz; 


/* size of segment */ 


ushort 


shm cpid; 


/* creator pid */ 


ushort 


shm Ipid; 


/+ pid of last operation +/ 


short 


shm nattch; 


/* munber of current attaches */ 


time_t 


shm atime; 


/* last attach time */ 


time_t 


shm dtime; 


/* last detach time */ 


time_t 


shm ctime; 


/+ last change time */ 

/+ Times measured in sees since */ 

/* 00:00:00 GMT, Jan. 1, 1970 +/ 



Shared memory identifiers may be created using sidipc (3C). 

Shm perm is a ipc_perm structure that specifies the shared memory operation 

permission (see below). This structure includes the following members: 
ushort cuid; /* creator user id */ 

ushort cgid; /* creator group id +/ 

ushort uid: /* user id */ 

ushort gid; /* group id */ 

ushort mode; /* r/w permission */ 

Shm segsz specifies the size of the shared memory segment. Shm cpid is the 

process id of the process that created the shared memory identifier. Shm Ipid 

is the process id of the last process that performed a shmop{2) operation. 

Shm nattch is the nmnber of processes that currently have this segment 

attached. Shnx_atime is the time of the last shmat operation, shm dtime is 
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the time of the last shmdt operation, cind shni__ctinie is the time of the last 
shmctl{2) operation that changed one of the members of the above structure. 

shared memory operation permissions 

In the shmop{2) and shmctl{2) system call descriptions, the permission required 
for an operation is given as "{token}", where "token" is the type of permission 
needed interpreted as follows: 

00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions on a shmid are granted to a process if one or more 
of the following are true: 

The process's effective user ID is super-user. 

The process's effective user ID matches shin perm.[c]uid in the data 

structure associated with shmid and the appropriate bit of the "user" por- 
tion (0600) of 8hm_perm,niode is set. 

The process's effective user ID does not match shm perin.[c]uid and 

either the process's effective group ID matches shm perin.[c]gid or one of 

shm perm.[c]gid is in the process's group access list and the appropriate 

bit of the "group" portion (060) of shm pertn.mode is set. 

The process's effective user ID does not match shm perm.[c]uid and the 

process's effective group ID does not match shm permi.[c]gid and neither 

of shm perm.[c]gid is in the process's group access list and the appropri- 
ate bit of the "other" portion (06) of shm perm.mode is set. 

Otherwise, the corresponding permissions are denied. 

shell The shell functions as both a command interpreter and an interpretive program- 

ming language. The shell is automatically invoked for every user who logs in, in 
order to provide a user- interface to the HP-UX operating system. See 5/1(1) and 
the tutorials supplied with your system for details. 

shell program See shell script. 

shell script A sequence of shell commands and shell programming language constructs stored 

in a file and invoked as a user command (program). No compilation is needed 
prior to execution, because the shell recognizes the commands and constructs 
that make up the shell programming language. A shell script is often called a 
shell program or a command file. See the shell programming article included in 
HP-UX Selected Articles. 

signal Signals are software interrupts sent to processes, informing them of special situa- 

tions or events. See signal{2). 

single-user state A condition of the HP-UX operating system in which the system console pro- 
vides the only communication mechanism between the system and its user. By 
default, the Series 300 single- user state is state 1, and the Series 500 multi-user 
state is state 2. Do not confuse the single-user state, in which the software is 
limiting a multi-user system to a single-user communication, with a single-user 
system, which can never communicate with more than one fixed terminal. See 
multi-user state. 

special file Often called a device file, this is a file associated with an I/O device. Special files 

are read and written the same as ordinary files, but requests to read or write 
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special processes 



standard error 



standard input 



result in activation of the associated device. Due to convention and consistency, 
these files should always reside in the /dev directory. 

I 

Processes with certain (small) process ID's are special. On a typical system, the 
id's of 0, 1, and 2 are assigned as follows: Process is the scheduler. Process 1 
is the initialization process init, and is the ancestor of every other process in the 
system. It is used to control the process structure. On paging systems with vir- 
tual memory process 2 is the paging daemon. 

On the Series 500, there is no process £ind the scheduler does not exist as an 
identifiable entity. The paging daemon also does not exist as an identifiable 
entity. 

The destination of error and special messages from a program. The standard 
error file is often CEilled stderr, and is automatically opened for writing on file 
descriptor 2 for every command invoked. By default, the user's terminal is the 
destination of all data written to stderr, but it can be redirected elsewhere. 
Unlike standard input and standard output which are never used for data 
transfer in the "wrong" direction, standard error is occasionally read. This is not 
recommended practice as I/O redirection is likely to break a program doing this. 

The source of input data for a program. The standard input file is often called 
stdin, and is automatically opened for reading on file descriptor for every com- 
mand invoked. By default, the user's terminal is the source of all data read from 
stdin, but it can be redirected from another source. 

standard output The destination of output data from a program. The standard output file is 
often called stdout, and is automatically oj)ened for writing on file descriptor 1 
for every conmiand invoked. By default, the user's terminal is the destination of 
all data written to stdout, but it can be redirected elsewhere. 

stream A term most often used in conjunction with the standard I/O library routines 

dociunented in section (3) of this manual. A stream is simply a file pointer 
(declared as FILE ^stream) returned by the fopen{3S) library routines. It may 
or may not have buffering associated with it (by default, buffering is assigned, 
but this may be modified with setbuf{3S)). 

sticky bit A single bit in the mode of every file in the file system. If set, the contents of 

the file stay permanently in memory instead of being swapped back out to disk 
when the file has finished executing. Only the super-user C£in set the sticky bit. 
The sticky bit is read each time the file is executed (via exec{2)). 

sub-directory A directory that is one (or perhaps more) levels lower in the file system hierar- 
chy than a given directory. Sometimes called a subordinate directory. 

subordinate directory 

See sub-directory. 

super block A block on each file system's mass storage medium which describes the file sys- 

tem. The contents of the super-block vary between implementations. Refer to 
the System Administrator Manual supplied with your system, and the appropri- 
ate /s(4) entry for details. 

super-user The HP-UX system administrator. This user has access to all files, and can per- 

form privileged operations. He has a real and effective user ID of 0, and, by con- 
vention, the user name of root. 



superior directory 



See parent directory. 
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system asynchronous I/O 

is a method of performing I/O whereby a process informs a driver or subsystem 
that it wants to know when data has arrived or when it is possible to perform a 
write request. The driver or subsystem maintains a set of buffers through which 
the process performs I/O. See the ioctl(2), select{2), read(2), and ujrite{2) 
manual pages for more information. 

system call An HP-UX operating system kernel function available to the user through a 

high-level language (such as FORTRAN, Pascal, or C). Also called an "intrin- 
sic" or a "system intrinsic." The available system calls are documented in sec- 
tion (2) of the HP- UX Reference manual. 

system console A keyboard and display (or terminal) given a unique status by HP-UX and asso- 
ciated with the special file /dev /console. All boot ROM or system loader error 
messages, HP-UX system error messages, and certain system status messages are 
sent to the system console. Under certain conditions (such as the single-user 
state), the system console provides the only mechanism for communicating with 
HP-UX. See HP-UX Selected Articles and the System Administrator Manual 
provided with your system for details on configuration and use of the system 
console. 

system loader On the Series 500, a piece of executable code that permanently resides in the 
computer. When the computer is powered up, the system loader is automatically 
loaded £ind rim. Its function is to find and load an operating system. The Series 
300 has an identical program which differs only in implementation. On the 
Series 300, the program resides in Read Only Memory (ROM). For a complete 
description of the system loader's function for all implementations, see boot 
ROM. 

terminal affiliation 

The process by which a process group leader establishes an association between 
itself and a particular terminal. A terminal becomes affiliated with a process 
group leader (and subsequently all processes created by the process group leader, 
see terminal group) whenever the process group leader executes (either directly 
or indirectly) an open{2) or creat{2) system call to open a terminal. Then, if the 
process which is executing open{2) or creat{2) is a process group leader, and if 
that process group leader is not yet afi&liated with a terminal, and if the terminal 
being opened is not yet £iffiliated with a process group, the affiliation is esta- 
blished. 

An affiliated terminal keeps track of its process group afiBliation by storing the 
process group's process group ID in an internal structure. 

Two benefits are realized by terminal affiliation. First, all signals sent from the 
terminal are sent to all processes in the terminal group. Second, all processes in 
the terminal group can perform I/O to/from the generic terminal driver 
/dev/tty, which automatically selects the affiliated terminal. 

Terminal affiliation is broken with a terminal group when the process group 
leader terminates, after which the hangup signal is sent to all processes remain- 
ing m the process group. Also, if a process (which is not a process group leader) 
in the terminal group becomes a process group leader via the setpgrp{2) system 
call, its terminal affiliation is broken. 

See process group, process group leader, terminal group, and setpgrp{2). 
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terminal group A terminal group is a process group whose process group leader has established 
affiliation with a particular terminal. Once a process group leader has esta- 
blished affiliation with a terminal, all processes in that process group created 
after the affiliation are members of that terminal group. Processes existing 
before £md during the time when affiliation is established do not inherit the 
affiliation, and are thus not part of the terminal group. A terminal group is 
sometimes called a tty group. 

This grouping is used to terminate a group of related process upon termination 
of one of the processes in the group; see exit{2) and signal{2). 

See process group, process group leader, terminal affiliation, and setpgrp{2). 

tty group ID See terminal group . 

unit number Part of an address used for devices. A number whose meaming is software- and 
device-dependent, but which is often used to specify a particular disk drive in a 
device with a multi-drive controller. See the System Administrator Manual sup- 
plied with your system for details. 

volume number Part of an address used for devices. A number whose meaning is softw£ire- and 
device-dependent, but which is often used to specify a particular volume on a 
multi- volume disk drive. See the System Administrator Manual supplied with 
your system for details. 

working directory 

Each process has associated with it the concept of a current working directory. 
For a shell, this appears as the directory in which you currently reside. This is 
the directory in which relative path name (i.e., a path name that does not begin 
with "/ ") searches begin. It is sometimes referred to as the current directory, or 
the current working directory. 

zombie process The name given to a process which terminates for any reason, but whose parent 
process has not yet waited for it to terminate (via wait(2)). The process which 
terminated continues to occupy a slot in the process table until its parent process 
waits for it. Because it has terminated, however, there is no other space allo- 
cated to it either in user or kernel space. It is therefore a relatively harmless 
occurrence which will rectify itself the next time its parent process waits. The 
ps{l) command lists zombie processes as "defunct." 
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glob echo without 

n] tools_16 tools to process 

special functions of HP 2640 and 

up handle special functions of HP 

13tol, ltol3 convert between 

comparison diffS 

hpicontrol, hpidelete, hpiend,/ 

terminal interface for Version 

f77, fc FORTRAN 

tcio Command Set 

sequence table for languages with 

integer and base-64 ASCH string 



abs return integer 

fabs floor, ceiling, remainder, 

requests 

utime set file 

ct cartridge tape 

a file 

disk direct disk 

ALLBASE/HP-UX HPIMAGE database 

getgroups get group 

initgroups initialize group 

setgroups set group 

machine-independent/ sputl, sgetl 

chmod, fchmod ch£inge 

memchmd change memory segment 

change times of/ touch update 

query interactive IMAGE database 

tgoto, tputs emulate /etc/termcap 

/setutent, endutent, utmpname 

access determine 

acct enable or disable process 

acctconl, acctcon2 connect-time 

acctprcl, acctprc2 process 

turnacct shell procedures for 

/accton, acctwtmp overview of 

of accounting and miscellaneous 

diskusg generate disk 

acct per-process 

acctcom search and print process 

acctmerg merge or add total 

command smnmary from per-process 

fwtmp, wtmpfix manipulate connect 

runacct run daily 

accounting 

format 

per-process accounting records 

accounting file(s) 

accounting 

acctconl, 

acctwtmp overview of accoimting/ 

overview of accounting/ acctdisk, 

accounting files 

accoimting/ acctdisk, acctdusg, 



'\' escapes csh(l) 

16-bit characters nl_tools_16(3C) 

2621-series terminals hp handle hp(l) 

2640 and 2621-series terminals lip(l) 

3-byte integers and long integers 13tol(3C) 

3-way differential file diff3(l) 

3X hpibegin, hpiclose, hpimage 

6/PWB compatibility stty sttyv6(7) 

77 compiler f77(l) 

80 Cartridge Tape Utility tcio(l) 

8-bit character sets /collating col seq_8(4) 

a641, 164a convert between long a641(3C) 

abort generate an lOT fault abort(3C) 

abs return integer absolute value abs(3C) 

absolute value abs(3C) 

absolute value functions /fmod, floor (3M) 

accept, reject allow/prevent LP accept (IM) 

access and modification times utime(2) 

access ct(7) 

access determine accessibility of access(2) 

access disk(7) 

access interactive tool iquery iquery(l) 

access list getgroups(2) 

access list initgroups(3C) 

access list setgroups(2) 

access long integer data in a sputl(3X) 

access mode of file chmod(2) 

access modes , memchmd(2) 

access, modification, and/or touch(l) 

access query(l) 

access routines /tgetstr, termcap(3X) 

access utmp file entry getut(3C) 

accessibility of a file access(2) 

accounting acct(2) 

accounting acctcon(lM) 

accounting acctprc(lM) 

accounting /shutacct, startup, acctsh(lM) 

accounting and miscellaneous/ acct(lM) 

accounting commands /overview acct(lM) 

accoimting data by user ID diskusg(lM) 

accounting file format acct(4) 

accounting file(s) acctcom(l) 

accounting files acctmerg(lM) 

accounting records acctcms acctcms(lM) 

accounting records fwtmp(lM) 

accounting nmacct(lM) 

acct enable or disable process acct (2) 

acct per-process accounting file acct (4) 

acctcms command sununary from acctcms(lM) 

acctcom search and print process acctcom(l) 

acctconl, acctcon2 connect-time acctcon(lM) 

acctcon2 connect-time accounting acctcon(lM) 

acctdisk, acctdusg, accton, acct(lM) 

acctdusg, accton, acctwtmp acct(lM) 

acctmerg merge or add total acctmerg(lM) 

accton, acctwtmp overview of acct(lM) 
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accounting 

acctprcl, 

and/ acctdisk, acctdusg, accton, 

process times time print 

process times times print 

fmictions sin, cos, tan, asin, 

hpib ^pass ctl change 

jobs list 

killall kill all 

hpib_Abort stop 

print current SCCS file editing 

paging/swapping swapon 

acctmerg merge or 

putenv change or 

swapping swapon enable 

iomap physical 

pathalias electronic 

memfree allocate and free 

memulck lock/imlock process 

ctime(3C) tztab time zone 

files 

admin create and 

/RETURN, ERROR, compile, step, 

devices vson, vsoff 

patterns memadvise 

usage vsadv 

alarm set a process's 

unalias discard specified 

filename 

/locate a program file including 

access interactive tool iquery 

utilities hpiutil 

interface isql 

memallc, memfree 

/lock process into memory, eifter 

sbrk change data segment space 

free, realloc, calloc main memory 

mallinfo fast main memory 

line on HP-IB hpib_rqst^rvce 

accept, reject 

nice 

lex generate programs for lexical 

/update access, modification, 

alias substitute command 

whereis locate source, binary, 

sort sort 

output 

oscp copy, create, 

for portable archives 



acctprcl, acctprc2 process acctprc(lM) 

acctprc2 process accounting acctprc(lM) 

acctwtmp overview of accounting acct(lM) 

accimiulated shell and children sh(l) 

accimiulated user and system sh(l) 

acos, atan, atan2 trigonometric trig(3M) 

active controllers on HP-IB hpib_pass_ctl(3I) 

active jobs csh(l) 

active processes killall(lM) 

activity on specified HP-IB bus hpib_abort(3I) 

activity sact sact(l) 

adb debugger adb(l) 

add a swap device for interleaved swapon[HFS](2) 

add total accoimting files acctmerg(lM) 

add value to environment putenv(3C) 

Eidditional device for paging and swapon[HFS](lM) 

address mapping iomap(7) 

address router pathalias(l) 

address space memallc, memailc(2) 

address space or segment memlck, memlck(2) 

adjust simple text formatter adjust(l) 

adjustment table for date(l) and tztab(4) 

admin create and administer SCCS admin(l) 

administer SCCS files admin(l) 

advance regular expression/ regexp(5) 

advise OS about backing store vson(2) 

advise OS about segment reference memadvise(2) 

advise system about backing store vsadv(2) 

afi asynchronous FIFO interface gpio(7) 

alarm clock alarm(2) 

alarm set a process's alarm clock alarm(2) 

alias C8h(l) 

alias substitute conmtiand and/or C8h(l) 

aliases and paths (csh(l) only) which(l) 

ALLBASE/HP-UX HPIMAGE database iquery(l) 

ALLBASE/HP-UX HPIMAGE database hpiutil(l) 

ALLBASE/HP-UX interactive SQL isql(l) 

alloc show dynamic memory usage csh(l) 

allocate and free address space memallc(2) 

allocating data and stack space dat«ilock(3C) 

allocation brk, brk(2) 

allocator malloc, malloc(3C) 

allocator /calloc, mallopt, malloc(3X) 

allow interface to enable SRQ hpib_rqst_srvce(3I) 

allow/prevent LP requests accept (IM) 

alter command priority csh(l) 

analysis of text lex(l) 

and/or change times of file touch(l) 

and/or filename csh(l) 

and/or manual for program whereis(l) 

and/or merge files sort(l) 

a.out assembler and link editor a.out(4) 

append to, split operating system oscp(lM) 

ar archive and library maintainer ar(l) 

ar common archive file format ar(4) 
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language be 

for portable archives ar 

cpio format of cpio 

ar common 

autobkup backup or 

backup backup or 

object libraries ranlib 

tar tape file 

library maintainer for portable 

upm unpack cpio 

cpio copy file 

arcv convert 

format 

osmark mark SDF volume boot 

check integrity of OS in SDF boot 

varargs handle variable 

formatted output of a varargs 

command xargs construct 

opterr get option letter from 

expr evaluate 

execute resulting/ eval read 

execute resulting/ eval read 

echo echo (print) 

set set/define flags and 

definition/setting of flags and 

echo echo (print) 

formatted output with numbered 

echo echo (print) 

set set/define flags and 

definition/setting of flags and 

be arbitrary-precision 

asa interpret 

control characters 

between long integer and base-64 

/nl ctime, localtime, gmtime, 

trigonometric/ sin, cos, tan, 

help 

a.out 

as 

astrn translate 

atrans translate 

assert verify program 

setbuf, setvbuf 

enable/disable interrupts for the 

space sigspace 

afi 

control modem 

aterm general purpose 

later time 

sin, cos, tan, asin, acos, 

sin, cos, tan, asin, acos, atan, 

asynchronous terminal emulation 

string to/ strtod. 



arbitrary-precision jirithmetic bc(l) 

archive and library maintainer ar(l) 

archive cpio(4) 

archive file format ar(4) 

archive file system autobkup(lM) 

archive file system backup(lM) 

archive symbol table format for ranlib(4) 

archiver tar(l) 

eirchives ar archive and ^(1) 

archives from HP media upm(l) 

archives in and out cpio(l) 

archives to new format arcv(l) 

arcv convert archives to new arcv(l) 

area as loadable/non-loadable osmark(lM) 

area(s) osck osck(lM) 

argument list varargs(5) 

argument list /vsprintf print vprintf(3S) 

argument list(s) and execute xargs(l) 

argument vector /optarg, optind, getopt(3C) 

Eirgimaents as an expression expr(l) 

arguments as shell input and csh(l) 

arguments as shell input and ^^(1) 

arguments csh(l) 

arguments csh(l) 

arguments unset remove csh(l) 

arguments echo(l) 

argmnents /sprintmsg print printmsg(3C) 

arguments sh{l) 

arguments sh(l) 

argmnents unset remove sh(l) 

arithmetic language bc(l) 

ASA carriage control characters asa(l) 

asa interpret ASA carriage asa(l) 

ASCII string a641, 164a convert a641(3C) 

asctime, nl asctime, timezone,/ ctime(3C) 

asin, acos, atan, atan2 » trig(3M) 

ask for help help(l) 

assembler and link editor output a.out(4) 

assembler as(l) 

assembly language astm(l) 

assembly language atrans(l) 

assert verify program assertion assert(3X) 

assertion assert(3X) 

assign buffering to a stream file setbuf(3S) 

associated eid io__interrupt_ctl io_interrupt_ctl(3I) 

assure sufiicient signal stack sigspace(2) 

astrn translate assembly language astrn(l) 

asynchronous FIFO interface gpio(7) 

asynchronous serial modem line modem (7) 

£isynchronous terminal emulation aterm(l) 

at, batch execute commands at a at(l) 

atan, atan2 trigonometric/ trig(3M) 

atan2 trigonometric functions trig(3M) 

aterm general purpose aterm(l) 

atof, nl strtod, nl atof convert strtod(3C) 
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strtol, atol, 

integer strtol, 

signals and wait for/ sigpause 

language 

chatr change program's internal 

getprivgrp get special 

setprivgrp get and set special 

setprivgrp set special 

system 

wait 

processing language 

wait wait for 

vson, vsoff advise OS about 

vsadv advise system about 

col filter reverse line-feeds and 

system 

autobkup 

backup 

letters 

ttytype data 

terminfo terminal capability data 

convert between long integer find 

(visual) display editor 






basic Technical 

time at, 

language 

initialization shell/ brc, 

cb C program 

su 

the requested status condition 

bifmkfs construct a 

check and interactive/ biffsck 

biffsdb 

bif 

jO, jl, jn, yO, yl, yn 

utilities 

bifls list contents of 

bifmkdir make a 

bifchmod change mode of a 

bifcp copy to or from 

bifrm, bifrmdir remove 

biffind find files in a 

group bifchown, 

file 

owner or group 

blocks 

system 

consistency check and/ 

directories 



atoi convert string to integer strtol(3C) 

atol, atoi convert string to strtol(3C) 

atomically release blocked sigpause(2) 

atrans translate assembly atrans(l) 

attributes chatr(l) 

attributes for group getprivgrp(l) 

attributes for group getprivgrp, getprivgrp(2) 

attributes for group setprivgrp(lM) 

autobkup backup or archive file autobkup(lM) 

await completion of process wait(l) 

awk text pattern scanning and awk(l) 

background processes csh(l) 

backing store devices vson(2) 

backing store usage vsadv(2) 

backspaces col(l) 

backup backup or archive file backup(lM) 

backup or archive file system autobkup(lM) 

backup or archive file system backup(lM) 

banner make posters in large banner(l) 

base of terminal types by port ttytype(4) 

base terminfo(4) 

base-64 ASCII string a641, 164a a641(3C) 

based on ex vi screen-oriented vi(l) 

KoQonQmo HirriQTTiiJ oyfrQ/^f ................ K^atirinmp/ 1 1 

BASIC interpreter basic(l) 

basic Technical BASIC interpreter basic(l) 

batch execute commands at a later at(l) 

be arbitrary-precision arithmetic t>c(l) 

bcheckrc, re, powerfail system brc(lM) 

bdiffbigdiff bdiff(l) 

beautifier, formatter cb(l) 

become super-user or another user su{l) 

becomes true /wait until hpib_status_wait(3I) 

Bell file system bifmkfs(lM) 

Bell file system consistency biff'sck(lM) 

Bell file system debugger biffsdb(lM) 

bell interchange format utilities bif(4) 

Bessel functions bessel(3M) 

bfs big file scanner bfs(l) 

bif bell interchange format bif (4) 

BIF directories bifls(l) 

BIF directory bifmkdir(l) 

BIF file bifchmod(l) 

BIF files bifcp(l) 

BIF files or directories bifrm(l) 

BIF system biffind(l) 

bifchgrp change file owner or bifchown(l) 

bifchmod chfinge mode of a BIF bifchmod(l) 

bifchown, bifchgrp change file bifchown(l) 

bifcp copy to or from BIF files bifcp(l) 

bifdf report number of free disk bifdf(lM) 

biffind find files in a BIF biffind{l) 

biffsck Bell file system biffsck(lM) 

biffsdb Bell file system debugger biffsdb(lM) 

bifls list contents of BIF bifls(l) 
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system 

or directories 

directories bifrm, 

bdiff 

bfs 

whereis locate source, 

cpset inst£ill object files in 

strings in a object, or other 

file fread, fwrite buffered 

bsearch 

tfind, tdelete, twalk manage 

library interface 

sum print checksum and 

blmode terminal 

sigblock 

sync update the super 

sigpause atomically release 

bifdf report number of free disk 

df report number of free disk 

report number of free SDF disk 

osmark mark SDF volume 

osck check integrity of OS in SDF 

reboot 

utility hpux HP-UX 

boot 

system initialization shell/ 

for/next loop 

for /next loop 

after endsw breaksw 

resume after endsw 

space allocation 

modest-sized programs 

table 

utmp, wtmp, btmp utmp, wtmp, 

format utmp, wtmp, 

stream file fread, fwrite 

package stdio standard 

setbuf, setvbuf assign 

I/O with an HP-IB channel from 

hpib Hewlett-Packard Interface 

stop activity on specified HP-IB 

conduct parallel poll on HP-IB 

conduct a serial poll on HP-IB 

hpib_send cmnd send command 

swab swap 

cc 

cflow generate 

debugger cdb, fdb, pdb 

cpp the 

cb 

lint a 

cxref generate 

mkstr extract error messages from 



bifinkdir make a BIF directory biftnkdir(l) 

bifmkfs construct a Bell file „,„,„ biftnkfs(lM) 

bifrm, bifrmdir remove BIF files bifrm(l) 

bifrmdir remove BIF files or bifrm(l) 

bigdiff bdiff(l) 

big file scanner bfs(l) 

binary, and/or manual for program whereis(l) 

bineiry directories cpset(lM) 

binary, file /find the printable strings(l) 

binary input/output to a stream fread(3S) 

binary search a sorted table bsearch(3C) 

binary search trees tsearch, tsearch(3C) 

blmode terminal block mode blmode(3C) 

block count of a file sum(l) 

block mode library interface blmode(3C) 

block signals sigblock(2) 

block sync(lM) 

blocked signals and wait for/ sigpause(2) 

blocks bifdf(lM) 

blocks df(lM) 

blocks sdfdf sdfdf(lM) 

boot area as/ osmark(lM) 

boot area(s) osck(lM) 

boot bootstrap process boot(lM) 

boot the system reboot(2) 

bootstrap and installation hpuxboot(lM) 

bootstrap process boot(lM) 

brc, bcheckrc, re, powerfail brc(lM) 

break exit from enclosing csh(l) 

break exit from enclosing sh(l) 

break from switch and resume csh(l) 

breaksw break from switch and csh(l) 

brk, sbrk change data segment brk(2) 

bs a compiler/interpreter for bs(l) 

bsearch binary search a sorted bsearch(3C) 

btmp entry format utmp(4) 

btmp utmp, wtmp, btmp entry utmp(4) 

buflFered binary input/output to a fread(3S) 

buffered input/output stream file stdio(3S) 

buffering to a stream file setbuf(3S) 

buffers hpib io perform hpib io(3I) 

Bus driver hpib(7) 

bus hpib abort hpib_abort(3I) 

bus hpib_ppoll hpib_ppoll(3I) 

bus hpib_spoll hpib__spoll(3I) 

bytes over HP-IB hpib_send cmnd(3I) 

bytes swab(3C) 

C compiler cc(l) 

C flow graph cflow(l) 

C, FORTRAN, Pascal symbolic cdb(l) 

C language preprocessor cpp(l) 

C program beautifier, formatter cb(l) 

C program checker/verifier lint(l) 

C program cross-reference cxref(l) 

C source into a file mkstr(l) 
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sizes disksecn 

dc desk 

cal print 

terminal emulator cu 

returned by stat/fstat system 

spawn getty to a remote terminal 

malloc, free, realloc, 

main/ malloc, free, realloc, 

ermo error indicator for system 

exercise link and unlink system 

use findstr(l) output to insert 

LP line printer Ip, 

terminfo terminal 

description into a terminfo/ 

return status lines of GPIO 

set control lines on GPIO 

asa interpret ASA 

ct 

hard disk, flexible disk, or 

tcio Conmiand Set 80 



files 

catman create the 

and uncompress files, and 

findmsg, dumpmsg create message 

generate a formatted message 

getmsg get message from a 

catread MPE/RTE-style message 

strings for inclusion in message 

the manual 

catalog support 

formatter 

files, and/ compact, uncompact. 



symbolic debugger 

of an sees delta 

remainder, absolute value/ floor, 

floor, ceil, fmod, fabs floor, 

chmod, fchmod 

HP-IB hpib_pass_ctl 

chdir 

allocation brk, sbrk 

chsh 

bifchown, bifchgrp 

chown, chgrp 

notify notify user of 

passwd 

modes memchmd 



cal print calendar cal(l) 

calculate default disc section disksecn(lM) 

calculator dc(l) 

calendar cal(l) 

calendar reminder service calendar(l) 

call another (UNIX) system; cu(l) 

call Stat data stat(5) 

(call terminal) ct ct(l) 

calloc main memory allocator malloc(3C) 

calloc, mallopt, mallinfo fast malloc(3X) 

calls ermo(2) 

calls link, unlink link(lM) 

calls to getmsg(3e) insertmsg insertnisg(l) 

cancel send/cancel requests to an lp(l) 

capability data base terminfo(4) 

captoinfo convert a termcap captoinfo(lM) 

card gpio_get^status gpio_get^status(3I) 

card gpio_jet_ctl gpio_set_ctl(3I) 

carriage control characters asa(l) 

cartridge tape access ct(7) 

cartridge tape media /initialize mediainit(l) 

eartridge Tape Utility tcio(l) 

case label in a switch statement csh(l) 

casuEi usersy euit cdit(l) 

cat concatenate, copy, and print cat(l) 

cat files for the manual catman(lM) 

cat them /ccat compress compact(l) 

catalog file for modification findmsg(l) 

catalog file gencat gencat(l) 

catalog getmsg(3e) 

catalog support catread(3C) 

catdogs findstr find findstr(l) 

catman create the cat files for catman(lM) 

catread MPE/RTE-style message catread(3e) 

cb e program beautifier, cb(l) 

cc e compiler ^^i^) 

ccat compress and uncompress compact (1) 

cd change working directory cd(l) 

cd change working directory csh(l) 

cd change working directory sh(l) 

cdb, fdb, pdb e, FORTRAN, Pascal cdb(l) 

cdc change the delta commentary cdc(l) 

ceil, ftnod, fabs floor, ceiling, floor(3M) 

ceiling, remainder, absolute/ floor(3M) 

cflow generate C flow graph cflow(l) 

change access mode of file chmod(2) 

chsmge active controllers on hpib_pass_ctl(3I) 

change current working directory csh(l) 

change data segment space brk(2) 

change default login shell chsh(l) 

change file owner or group bifchown(I) 

change file owner or group chown(l) 

change in job status csh(l) 

change login password pas8wd(l) 

change memory segment access memchmd(2) 



Permuted Index 



chmod 

bifchmod 

sdfchmod 

environment putenv 

rtprio 

newfonn 

chown, fchown 

file sdfchown, sdfchgit) 

nice 

attributes chatr 

chroot 

conunand chroot 

sees delta cdc 

eiccess, modification, and/or 

delta make a delta 

system or version chsys 

cd 

chdir 

cd 

cd 

hpib_Jo perform I/O with an HP-IB 

pipe create an interprocess 

imgetc push 

wc word, line, and 

cuserid get 

/set up read termination 

getc, getchar, fgetc, getw get 

putc, putchar, ^utc, putw put 

table for languages with 8-bit 

/strpbrk, strspn, strcspn, strtok 

interpret ASA carriage control 

_tolower, toascii translate 

iscntrl, isascii classify 

nl toupper, nl tolower translate 

/nl isprint, nl isgraph classify 

rmnl remove extra new-line 

vis, inv make imprintable 

tools to process 16-bit 

tr translate 

lastlogin, monacct, nuUadm,/ 

attributes 

directory 

/Bell file system consistency 

fsck file system consistency 

fsck file system consistency 

area(s) osck 

/SDF file system consistency 

of HP-UX files revck 

pwck, grpck password/group file 

lint a e program 

about the file systems 

file smn print 

chown, 

times get process and 



change mode chmod(l) 

change mode of a BIF file bifchmod(l) 

change mode of an SDF file sdfchmod(l) 

change or add value to putenv(3e) 

change or read realtime priority rtprio(2) 

change or reformat a text file newfonn(l) 

change owner and group of a file chown(2) 

change owner or group of an SDF sdfchown(l) 

change priority of a process nice(2) 

change program's internal chatr(l) 

change root directory chroot(2) 

change root directory for a chroot(lM) 

change the delta commentary of an cdc(l) 

change times of file /update touch(l) 

(change) to an SeeS file delta(l) 

change to different operating chsys(lM) 

change working directory cd(l) 

change working directory chdir(2) 

change working directory csh(l) 

change working directory sh(l) 

channel from buffers hpib_Jo(3I) 

channel pipe(2) 

character back into input stream ungetc(3S) 

character coimt wc(l) 

character login name of the user cuserid(3S) 

character on special file io_eol ^ctl(3I) 

character or word from a stream/ getc (38) 

character or word on a stream putc(3S) 

character sets /sequence col seq ■.8(4) 

character string operations string(3e) 

characters asa asa(l) 

characters /tolower, —toupper, conv(3e) 

characters /isprint, isgraph, ctype(3C) 

characters for use with NLS nl conv(3e) 

characters for use with NLS nl ctype(3C) 

characters from file rmnl(l) 

characters in a file visible or/ vis(l) 

characters nl tools_16 nl tools_16(3C) 

characters tr(l) 

chargefee, ckpacct, dodisk, acctsh(lM) 

chatr change program's internal chatr(l) 

chdir change current working csh(l) 

chdir change working directory chdir(2) 

check and interactive repair biffsck(lM) 

check and interactive repair fsck[HFS](lM) 

check and interactive repair f8ck[SDF](lM) 

check integrity of OS in SDF boot osck(lM) 

check, interactive repair sdfi'sck(lM) 

check internal revision numbers revck(lM) 

checkers pwck(lM) 

checker/verifier lint(l) 

checklist static information checklist(4) 

checksum and block count of a simi(l) 

chgrp change file owner or group chown(l) 

child process times times(2) 
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terminate wait wait for 

ulimit impose file size limit for 

time print acciunulated shell and 

of file 

group 

group of a file 

hpiput, hpiundo, hpiupdate, 

hpiimdo, hpiupdate, chpibegin, 

hpiupdate, chpibegin, chpiclose, 

a command 

operating system or version 

clrsvc clear x25 switched virtual 

monacct, nulladm,/ chargefee, 

isgraph, iscntrl, isascii 

NLS /nl isprint, nl isgraph 

unclean uucp spool directory 

clri 

clear 

circuit clrsvc 

inquiries ferror, feof, 

shell (command interpreter) with 

alarm set a process's alarm 

cron 

close 

fclose, fflush 
/telldir, seekdir, rewinddir, 

circuit 

backspaces 

languages with 8-bit/ col seq_8 

strncmpl6 non- ASCII string 

messages to form error log dmesg 

performance statistics vstat 

table for languages with 8-bit/ 

comb 

conunon to two sorted files 

alias substitute 

nice run a 

hpib send_cmnd send 

change root directory for a 

nohup ignore hangups during 

env set environment for 

uux UNIX system to UNIX system 

uuxqt uucp 

true if execute 

logouts, and quits nohup nm a 

source define source for 



child process to stop or wait(2) 

child processes sh(l) 

children process times sh(l) 

chmod change mode chmod(l) 

chmod, fchmod chfinge access mode chmod(2) 

chown, chgrp change file owner or chown(l) 

chown, fchown change owner and chown(2) 

chpibegin, chpiclose,/ /hpiopen, hpimage 

chpiclose, chpicontrol, /hpiput, hpimage 

chpicontrol, /hpiput, hpiundo, hpimage 

chroot change root directory chroot(2) 

chroot change root directory for chroot(lM) 

chsh change default login shell chsh(l) 

chsys change to different chsys(lM) 

circuit clrsvc(lM) 

ckpacct, dodisk, lastlogin, acctsh(lM) 

classify characters /isprint, ctype(3C) 

classify characters for use with nl ctype(3C) 

clean-up uuclean(lM) 

clear clear terminal screen clear(l) 

clear inode clri[non-SDF](lM) 

clear terminal screen clear(l) 

clear x25 switched virtual clrsvc(lM) 

clearerr, fileno stream status ferror(3S) 

C-like syntax csh a csh(l) 

clock alarm(2) 

clock daemon cron(lM) 

clock report CPU time used clock(3C) 

close a file descriptor close(2) 

close close a file descriptor close(2) 

close or flush a stream fclose(3S) 

closedir directory operations directory (3C) 

clri clear inode clri[non-SDF](lM) 

clrsvc clear x25 switched virtual clrsvc(lM) 

cmp compare two files cmp(l) 

col filter reverse line-feeds and col(l) 

collating sequence table for col seq 8(4) 

collation /stmcmpS, strcmpl6, nl string(3C) 

collect system diagnostic dmesg(lM) 

collect virtual memory vstat(lM) 

col seq 8 collating sequence col seq 8(4) 

comb combine SCCS deltas comb(l) 

combine SCCS deltas comb(l) 

comm select or reject lines comm(l) 

conmiand and/or filename csh(l) 

command at low priority nice(l) 

command bytes over HP-IB hpib_^end cmnd(3I) 

conmiand chroot chroot(lM) 

command execution csh(l) 

command execution env(l) 

command execution uux(l) 

command execution uuxqt(lM) 

command if expression evaluates csh(l) 

command inunune to hangups, nohup(l) 

command input csh(l) 



Permuted Index 



syntax csh a shell 

hash remember 

repeat execute 

getopt parse 

nice alter 

shell, the standard/restricted 

Utihty tcio 

of name as if a 

accounting records acctcms 

system issue a shell 

test condition evaluation 

time time a 

trap execute 

process exec execute 

process exec execute 

argiunent list(s) and execute 

and miscellaneous accounting 

at, batch execute 

shell input and execute resulting 

install install 

ioctl generic device control 

shell input and execute resulting 

to environment of subsequent 

non-zero while execute 

cdc change the delta 

ar 

comm select or reject lines 

ipcs report inter-process 

ftok standard interprocess 

and uncompress files, and cat/ 

diff, diffh differential file 

cmp 

file sccsdiff 

diffS 3-way differential file 

dircmp directory 

interface for Version 6/PWB 

expression regcmp, regex 

/step, advance regular expression 

/PEEKC, UNGETC, RETURN, ERROR, 

term format of 

ccC 

f77, fc FORTRAN 77 

pc Pascal 

tic terminfo 

yacc yet another 

modest-sized programs bs a 

erf, erfc error function and 

wait await 

compress, uncompress, zcat 

pack, peat, unpack 

and cat/ compact, imcompact, ccat 

compress and expand data 

files cat 

/wait until the requested status 

test 



(conamand interpreter) with C-like csh(l) 

command location in search path sh(l) 

command more than once csh(l) 

command options getopt(l) 

command priority csh(l) 

command programming language /rsh ... sh(l) 

Conmiand Set 80 Cartridge Tape tcio(l) 

command type show interpretation sh(l) 

command summary from per-process acctcms(lM) 

command system(3S) 

command test(l) 

conmiand time(l) 

command upon receipt of signal sh(l) 

conmiand without creating new csh(l) 

command without creating new sh(l) 

command xargs construct xargs(l) 

commands /overview of accounting acct(lM) 

commands at a later time at(l) 

commands eval read arguments as csh(l) 

commands install(lM) 

commands ioctl(5) 

commands eval read arguments as sh(l) 

commands /export variable names sh(l) 

commands while expression is csh(l) 

commentary of an SCCS delta cdc(l) 

common archive file format ar(4) 

common to two sorted files comm(l) 

commimication facilities status ipcs(l) 

communication package stdipc(3C) 

compact, uncompact, ccat compress compact(l) 

comparator diff(l) 

compare two files cmp(l) 

compare two versions of an SCCS sccsdiff(l) 

comparison diff3(l) 

comparison dircmp(l) 

compatibility stty terminal sttyv6(7) 

compile and execute regular regcmp(3X) 

compile and match routines regexp(5) 

compile, step, advance regular/ regexp(5) 

compiled term file term(4) 

compiler cc(l) 

compiler f77(l) 

compiler pc(l) 

compiler tic(lM) 

compiler-compiler yacc(l) 

compiler/interpreter for bs(l) 

complementary error function erf(3M) 

completion of process wait(l) 

compress and expand data compress(l) 

compress and expand files pack(l) 

compress and uncompress files, compact (1) 

compress, uncompress, zcat compress(l) 

concatenate, copy, and print cat(l) 

condition becomes true hpib status wait(3I) 

condition evaluation command test(l) 
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test evaluate 

bus hpib_spoll 

bus hpib_ppoll 

reconfig 

subsystem mklp 

Ipadmin 

fwtmp, wtmpfix manipulate 

an out-going terminal line 

acctconl, acctcon2 

repair bi£fsck Bell file system 

repair fsck file system 

repair fsck file system 

repair sdifsck SDF file system 

console system 

math math functions and 

biftnkfs 

mkfs 

newfs 

mkrs 

execute command xargs 

remove nrofF/troff, tbl, and eqn 

lifls list 

bifls list 

Is, 1, 11, Isf, Isr, Isx list 

sdfls, sdfll list 

csplit 

line goto 

nearest while or foreach 

enclosing for/next loop 

asa interpret ASA carriage 

ioctl generic device 

ioctl 

stty, gtty 

dialups, d passwd dialup security 

hpib eoi ctl 

fcntl file 

init, telinit process 

device interrupt (fault) 

gpio set_ctl set 

asynchronous serial modem line 

msgctl message 

semctl semaphore 

shmctl shared memory 

fcntl file 

on HP-IB hpib_card ppoll resp 

HP-IB hpib_ren_ctl 

uucp status inquiry find job 

vc version 

hpib_pass ctl change active 

tty 

mt magnetic tape interface and 

term 

units 

/fscanf, sscanf formatted input 



conditional expression csh(l) 

conduct a serial poll on HP-IB hpib_jspoll(3I) 

conduct parallel poll on HP-IB hpib_ppoll(3I) 

configure an HP-UX system reconfig(lM) 

configure the LP spooler mklp(lM) 

configure the LP spooling system Ipadmin(lM) 

connect accoimting records fwtmp(lM) 

connection /undial establish dial(3C) 

connect-time accoimting acctcon(lM) 

consistency check and interactive biifsck(lM) 

consistency check and interactive fsck[HFS)(lM) 

consistency check and interactive fsck[SDF](lM) 

consistency check, interactive sdffsck(lM) 

console interface console(7) 

console system console interface console(7) 

constants math(5) 

construct a Bell file system bifmkfs(lM) 

construct a file system mkfs[HFS](lM) 

construct a new file system newfs[HFS](lM) 

construct a recovery system mkrs(lM) 

construct argimient list(s) and xargs(l) 

constructs deroff derofF(l) 

contents of a LIF directory lifls(l) 

contents of RTF directories bifls(l) 

contents of directories ls(l) 

contents of SDF directories sdfls(l) 

context split csplit{l) 

continue execution on specified csh(l) 

continue resvune execution of csh(l) 

continue resume next iteration of sh(l) 

control characters asa(l) 

control conunands ioctl(5) 

control device ioctl(2) 

control device stty(2) 

control dialups(4) 

control EOI mode for HP-IB file hpib_eoi_ctl(3I) 

control fcntl(2) 

control initialization init(lM) 

control io_on interrupt io_on interrupt(3I) 

control lines on GPIO card gpio^set_ctl(3I) 

control modem modem(7) 

control operations nisgctl(2) 

control operations semctl(2) 

control operations shmctl(2) 

control options fcntl(5) 

control response to parallel poll hpib_card_ppoll resp(3I) 

control the Remote Enable line on hpib_ren ctl(3I) 

control uustat uustat(l) 

control vc(l) 

controllers on HP-IB hpib_pass_ctl(3I) 

controlling terminal interface tty(7) 

controls mt(7) 

conventional names for terminals term(5) 

conversion program units{l) 

conversion, read from streeun file scanf(3S) 
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into a tenninfo/ captoinfo 

arcv 

and long integers i3tol, ltoI3 

base-64 ASCII string a64I, 164a 

/timezone, daylight, tzname, tzset 

open or re-open a stream file; 

string ecvt, fcvt, gcvt, nl gcvt 

copy a (tape) file dd 

strtod, atof, nl strtod, nl atof 

number cvtnimi 

strtol, atol, atoi 

convert, reblock, translate, and 

cat concatenate, 

operating system oscp 

cpio 

uucico uucp 

cp, In, mv 

an SDF/ sdfcp, sdfln, sdfmv 

uucico uucp copy in and 

bifcp 

lifcp 

uuname UNIX system to UNIX system 

UNIX system to UNIX system file 

savecore save a 

core format of 

trigonometric fimctions sin, 

sinh, 

smn print checksmn and block 

wc word, line, and character 

files 

cpio format of 

upm unpack 

out 



binary directories 

sethostname set name of host 

clock report 

rewrite an existing one 

file tmpnam, tempnam 

existing one creat 

fork 

mknod 

ctags 

tmpfile 

pipe 

admin 

operating system oscp copy, 

modification findmsg, dumpmsg 

mknod 

manual catman 

umask set permissions mask for 

umask set permissions mask for 

exec execute command without 



convert a termcap description captoinfo(lM) 

convert archives to new format arcv(l) 

convert between 3-byte integers 13tol(3C) 

convert between long integer and a641(3C) 

convert date and time to string ctime(3C) 

convert file to stream /fdopen fopen(3S) 

convert floating-point nimiber to ecvt(3C) 

convert, reblock, translate, and dd(l) 

convert string to/ strtod(3C) 

convert string to floating point cvtnum(3C) 

convert string to integer strtol(3C) 

copy a (tape) file dd dd(l) 

copy, and print files cat(l) 

copy, create, append to, split oscp(lM) 

copy file archives in and out cpio(l) 

copy in and copy out uucico(lM) 

copy, link or move files cp(l) 

copy, link, or move files to/from sdfcp(l) 

copy out uucico(lM) 

copy to or from BIF files bifcp(l) 

copy to or from LIE files lifcp(l) 

copy uucp, uulog, uucp(l) 

copy uuto, uupick public uuto(l) 

core dump of the operating system savecore(lM) 

core format of core image file core(4) 

core image file core(4) 

cos, tan, asin, acos, atem, atan2 trig(3M) 

cosh, tanh hyperbolic functions sinJi(3M) 

cotmtofafile siun(l) 

coimt wc(l) 

cp. In, mv copy, link or move cp(l) 

cpio archive cpio(4) 

cpio archives from HP media upm(l) 

cpio copy file archives in and cpio(l) 

cpio format of cpio archive cpio(4) 

cpp the C language preprocessor cpp(l) 

cpset install object files in cpset(lM) 

cpu sethostname(2) 

CPU time used clock(3C) 

creat create a new file or creat(2) 

create a name for a temporary tmpnam(3S) 

create a new file or rewrite an creat(2) 

create a new process fork(2) 

create a special file entry mknod(4) 

create a tags file ctags(l) 

create a temporary file tmpfile(3S) 

create an interprocess channel pipe(2) 

create and administer SCCS files admin(l) 

create, append to, split oscp(lM) 

create message catalog file for findmsg(l) 

create special and fifo files mknod(lM) 

create the cat files for the catman(lM) 

creating new files csh(l) 

creating new files sh(l) 

creating new process csh(l) 
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exec execute command without 
umask set and get file 

crontab user 

cxref generate C program 

optimization package curses 

page file perusal filter for 

execution startup routines 

hashing encryption 

with C-like syntax 

file including aliases and paths 



terminal (call terminal) 

terminal 

gmtime, asctime, n! asctime,/ 

adjustment table for date(l) and 

terminal emulator 

gethostname get name of 

hostname set or print name of 

uname ^^rint name of 

activity sact print 

sigsetmask set 

whoami print effective 

the slot in the utmp file of the 

chdir change 

getcwd get path-name of 

imame get name of 

langinfo, langtoid, idtolang, 

optimization package 

of the user 

each line of a file 

line of a file cut 

point number 

cross-reference 

cron clock 

runacct run 

into memory, after allocating 

port ttytype 

terminfo terminal capability 

diskusg generate disk accounting 

zcat compress and expand 

sputl, sgetl access long integer 

plock lock process, text, or 

io_width ctl set width of 

prof display profile 

system call stat 

brk, sbrk change 

types primitive system 

iquery ALLBASE/HP-UX HPIMAGE 

query interactive IMAGE 

join relational 



creating new process sh(l) 

creation mask umask(2) 

cron clock daemon cron(lM) 

crontab file crontab(l) 

crontab user crontab file crontab(l) 

cross-reference cxref(l) 

CRT screen handling and curse8(3X) 

crt viewing more, more(l) 

crtO.o, mcrtO.o, frtO.o, mfrtO.o crtO(3) 

crypt encode/decode files crypt(l) 

crypt, setkey, encrypt generate crypt(3C) 

csh a shell (command interpreter) csh(l) 

(c«h(l) only) /locate a program which(l) 

csplit context split csplit(l) 

ct cartridge tape access ct(7) 

ct spawn getty to a remote ct(l) 

ctags create a tags file ctags(l) 

ctermid generate file name for ctermid(3S) 

ctime, nl ctime, localtime, ctime(3C) 

ctime(3C) tztab time zone tztab(4) 

cu call another (UNIX) system; cu(l) 

current host gethostname(2) 

current host system hostname(l) 

current HP-UX version uname(l) 

current SCCS file editing sact(l) 

current signal mask sigsetmask(2) 

current user id whoami(l) 

current user ttyslot find ttyslot(3C) 

current working directory csh(l) 

current working directory getcwd(3C) 

currentHP-UX system uname(2) 

currlangid information on user's/ langinfo(3C) 

curses CRT screen handling and curses(3X) 

cuserid get character login name cuserid(3S) 

cut cut out selected fields of cut(l) 

cut out selected fields of each cut(l) 

cvtnum convert string to floating cvtmmi(3C) 

cxref generate C program cxref(l) 

daemon cron(lM) 

daily accounting runacct(lM) 

data and stack space /process datalock(3C) 

data base of terminal types by ttytype(4) 

data base terminfo(4) 

data by user ID diskusg(lM) 

data compress, imcompress, compress(l) 

data in a machine-independent/ sputl(3X) 

data in memory plock(2) 

data path io_width_ctl(3I) 

data prof(l) 

data returned by stat/fstat stat(5) 

data segment space allocation brk(2) 

data types types(5) 

database access interactive tool iquery(l) 

database access query(l) 

database operator join(l) 
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tput query terminfo 
hpiutil ALLBASE/HP-UX HPIMAGE 

settimeofday get/set 

ftime get 

/daylight, tzname, tzset convert 

date print and set the 

stime set time and 

time zone adjustment table for 

/asctime, nl asctime, timezone, 

and copy a (tape) file 

strip remove symbols and 

adb 

bilfsdb Bell file system 

pdb C, FORTRAN, Pascal symbolic 

fsdb file system 

error log decode read and 

events from the error log 

untie terminfo 

disksecn calculate 

default label 

statement 

chsh change 

setenv 

response hpib_ppolI resp_ctl 

source 

switch 

arguments unset remove 

arguments unset remove 

unlink remove directory entry; 

tail 

I/O subsystem. 

the delta commentary of an SCCS 

delta make a 

cdc change the 

rmdel remove a 

SCCS file 

comb combine SCCS 

mesg permit or 

tset terminal 

and eqn constructs 

description into a terminfo 

disktab disk 

captoinfo convert a termcap 

lif logical interchange format 

operating system manager package 

sdf structured directory format 

close close a file 

dup duplicate an open file 

endfsent get file system 

dup2 duplicate an open file 

dc 



database tput(l) 

database utilities hpiutil(l) 

datalock lock process into datalock(3C) 

date and time gettimeofday, gettimeofday(2) 

date and time more precisely ftime(2) 

date and time to string ctime(3C) 

date date(l) 

date print and set the date date(l) 

date stime(2) 

date(l) and ctime(3C) tztab tztab(4) 

daylight, tzname, tzset convert/ ctime(3C) 

dc desk calculator dc(l) 

dd convert, reblock, translate, dd(l) 

debug information strip(l) 

debugger adb(l) 

debugger bifi'sdb(lM) 

debugger cdb, fdb, cdb(l) 

debugger fsdb[HFS](lM) 

decode diagnostic events from the decode(lM) 

decode read and decode diagnostic decode(lM) 

de-compiler untic(lM) 

default disc section sizes disksecn(lM) 

default in switch statement csh(l) 

default label default in switch csh(l) 

default login shell chsh(l) 

define environment variable csh(l) 

Define interface parallel poll hpib_ppoll resp ctl(3I) 

define source for command input csh(l) 

define switch statement csh(l) 

definition/setting of flags and csh ( 1 ) 

definition/setting of flags and sh(l) 

delete file imlink(2) 

deliver the last part of a file tail(l) 

delog diagnostic event logger for delog(lM) 

delta cdc change cdc(l) 

delta (change) to an SCCS file delta(l) 

delta commentary of an SCCS delta cdc(l) 

delta from an SCCS file rmdel(l) 

delta make a delta (change) to an delta(l) 

deltas comb(l) 

deny messages to terminal mesg(l) 

dependent initialization tset(l) 

deroff' remove nroff/trofl", tbl , deroff ( 1 ) 

description /convert a termcap captoinfo(lM) 

description flle disktab[HFS] (4) 

description into a terminfo/ captoinfo(lM) 

description lif(4) 

description osmgr osmgr(lM) 

description sdf(4) 

descriptor close(2) 

descriptor dup(2) 

descriptor file entry /setfsent, getfsent(3X) 

descriptor to a specific slot dup2(2) 

desk calculator dc(l) 

determine accessibility of a file access(2) 
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file 

terminated io get term reason 

specified file system fsclean 

ioctl generic 

Isdev list 

mkdev make 

lines for finite width output 

swapon add a swap 

swapon enable additional 

master master 

io_on interrupt 

ioctl control 

devnm 

stty, gtty control 

information for insf, mksf, Issf 

for CRT graphics 

advise OS about backing store 

blocks 

subsystem 

subsystem, delog 

log decode read and decode 

subsystem diagO 

log dmesg collect system 

out-going terminal line/ 

ratfor rational Fortran 

dialups, d_passwd 

control 

bdiff big 

comparator 

comparison 

sdiff side-by-side 

difiEmk mark 

version chsys change to 

diff, diflh 

diff3 3-way 

comparator diff, 

files 



disk 

bifls list contents of BIF 

bifrmdir remove BIF files or 

install object files in binary 

dir format of 

dir format of 

Isf, Isr, Isx list contents of 

rm, rmdir remove files or 

sdfls, sdfll list contents of SDF 

sdfrmdir remove SDF files or 

biftnkdir make a BIF 

cd change working 

chdir change working 

chroot change root 



determine file type file(l) 

determine how last read io__get_term reason(3I) 

determine shutdown status of fsclean(lM) 

device control commands ioctl(5) 

device drivers in the system Isdev(l) 

device files mkdev(lM) 

device fold fold long fold(l) 

device for interleaved/ swapon[HFS](2) 

device for paging and swapping swapon[HFS](lM) 

device information table master(4) 

device interrupt (fault) control io_on__interrupt(3I) 

device ioctl(2) 

device name devnm(lM) 

device stty(2) 

devices file of driver devices(4) 

devices /graphics information graphics(7) 

devices vson, vsoff vson(2) 

devnm device name devnm(lM) 

df report nmnber of free disk df(lM) 

diagO diagnostic interface to I/O diag0(7) 

diagnostic event logger for I/O delog(lM) 

diagnostic events from the error decode(lM) 

diagnostic interface to I/O diagO(7) 

diagnostic messages to form error dmesg(lM) 

dial, undial establish an dial(3C) 

dialect ratfor(l) 

dialup security control dialups(4) 

dialups, d ^passwd dialup security dialups(4) 

diff bdifl^(l) 

diff, diffh differential file diff(l) 

diff3 3-way differential file diff3(l) 

difference program sdiff(l) 

differences between files diffmk(l) 

different operating system or ch8ys(lM) 

differential file comparator diff(l) 

differential file comparison diff3(l) 

diffh differential file diff(l) 

diffmk mark differences between diffmk(l) 

dir format of directories dir(4) 

dir format of directories dir[HFS)(4) 

dircmp directory comparison dircmp(l) 

direct disk access disk(7) 

directories bifls(l) 

directories bifrm, bifrm(l) 

directories cpset cpset(lM) 

directories dir(4) 

directories dir[HFS](4) 

directories Is, 1, 11, ls(l) 

directories >'Qi(l) 

directories sdfls(l) 

directories sdfrm, sdfrm(l) 

directory biftnkdir(l) 

directory c<i(l) 

directory chdir(2) 

directory chroot(2) 
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uuclean uucp spool 

dircmp 

cd change working 

chdir change current workmg 

unlink remove 

mkdir make a 

rmdir remove a 

chroot change root 

sdf structured 

sdfinit initialize Structured 

get path-name of current working 

lifls list contents of a LIF 

mkdir make a 

mvdir move a 

pwd working 

pwd working 

seekdir, rewinddir, closedir 

ordinary file mknod make a 

sdfinkdir make an SDF 

cd change working 

dirs print the 

popd pop 

pushd push 

names basename, 

printers enable, 

acct enable or 

tables unhash 

handler intrapoiF, intrapon 

disksecn calculate default 

unalias 

type, modes, speed, and line 

disk direct 

diskusg generate 

bifdf report number of free 

df report number of free 

sdfdf report nmnber of free SDF 

disktab 

tape/ mediainit initialize hard 

in-core state with its state on 

/initialize hard disk, flexible 

prealloc preallocate 

prealloc preallocate fast 

du summarize 

section sizes 

data by user ID 

mount, umount mount and 

vi screen-oriented (visual) 

history 

prof 

hypot Euclidean 

/lcong48 generate imiformly 

messages to form error log 



directory clean-up uuclean(lM) 

directory comparison dircriip(l) 

directory csh(l) 

directory csh(l) 

directory entry; delete file unlink(2) 

directory file mkdir(2) 

directory file rmdir(2) 

directory for a commjind chroot(lM) 

directory format description sdf (4) 

Directory Format voliune sdfinit[SDF](lM) 

directory getcwd getcwd(3C) 

directory lifls(l) 

directory nikdir(l) 

directory mvdir(lM) 

directory name pwd(l) 

directory name sh(l) 

directory operations /telldir, directory (3C) 

directory, or a special or mknod(2) 

directory sdfmkdir(l) 

directory sh(l) 

directory stack csh(l) 

directory stack C8h(l) 

directory stack csh(l) 

dimame extract portions of path basename(l) 

dirs print the directory stack csh(l) 

disable enable/disable LP enable(l) 

disable process accoimting acct(2) 

disable use of internal hash csh(l) 

disable/enable integer trap intrapoff(3m) 

disc section sizes disksecn(lM) 

discard specified alias csh(l) 

discipline getty set terminal getty(lM) 

disk access disk(7) 

disk accounting data by user ID diskusg(lM) 

disk blocks bifdf(lM) 

disk blocks df(lM) 

disk blocks 8dfdf(lM) 

disk description file disktab[HFS](4) 

disk direct disk access disk(7) 

disk, flexible disk, or cartridge mediainit(l) 

disk fsync synchronize a file's fsync(2) 

disk, or cartridge tape media mediainit(l) 

disk storage prealloc(l) 

disk storage prealloc(2) 

disk usage du(l) 

disksecn calculate default disc disksecn(lM) 

disktab disk description file disktab[HFS] (4) 

diskusg generate disk accounting diskusg(lM) 

dismount file system mount[HFS](lM) 

display editor based on ex vi(l) 

Display event history list csh(l) 

display profile data prof(l) 

distance function hypot(3M) 

distributed pseudo-random nmnbers drand48(3C) 

dmesg collect system diagnostic dmesg(lM) 
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macros mm, osdd print/check 

MM macro package for formatting 

nulladm,/ chargefee, ckpacct, 

whodo which users are 

/nl atof convert string to 

dialups, 

nrand48, mrand48, jr£ind48,/ 

Hewlett-Packard Interface Bus 

mksf, Issf devices file of 

pty pseudo terminal 

Isdev list device 

od, xd octal and hexadecimal 

savecore save a core 

file for modification findmsg, 

descriptor 

descriptor to a specific slot 

dup 

to a specific slot dup2 

nohup ignore hangups 

alloc show 



ecno 
echo 
echo 
glob 
floating-point number to string 

end, etext, 

for casual users) 

sact print current SCCS file 

screen-oriented (visual) display 

ed, red text 

ex text 

Id link 

a.out assembler and link 

sed stream text 

users) edit text 

setresuid, setresgid set real, 

whoami print 

effective user, real group, and 

/getgid, getegid get real user, 

hashstat print hcish table 

new process in a virtual memory 

pattern grep, 

interrupts for the associated 

pathalias 

/tgetflag, tgetstr, tgoto, tputs 

purpose asynchronous terminal 

another (UNIX) system; terminal 

paging and swapping swapon 

printers 



dociunents formatted with the MM mm(l) 

docmnents mm the mm(5) 

dodisk, lastlogin, monacct, acctsh(lM) 

doing what whodo(lM) 

double-precision mmaber strtod(3C) 

d passwd dialup seciu-ity control dialups(4) 

drand48, erand48, lrand48, drand48(3C) 

driver hpib hpib(7) 

driver information for insf, devices(4) 

driver pty(7) 

drivers in the system Isdev(l) 

du summarize disk usage du(l) 

dump od(l) 

dump of the operating system savecore(lM) 

dumpmsg create message catalog findmsg(l) 

dup duplicate an open file dup(2) 

dup2 duplicate an open file dup2(2) 

duplicate an open file descriptor dup(2) 

duplicate an open file descriptor dup2(2) 

during command execution csh(l) 

dynamic memory usage csh(l) 

echo echo (print) arguments csh(l) 

echo echo (print) arguments echo(l) 

echo echo (print) arguments sh(l) 

echo (print) arguments csh(i) 

echo (print) arguments echo(l) 

echo (print) arguments sh(l) 

echo without '\' escapes csh(l) 

ecvt, fcvt, gcvt, nl_gcvt convert ecvt(3C) 

ed, red text editor ed(l) 

edata last locations in program end(3C) 

edit text editor (variant of ex edit(l) 

editing activity sact(l) 

editor based on ex vi vi(l) 

editor ed(l) 

editor ex(l) 

editor ld(l) 

editor output a.out(4) 

editor sed(l) 

editor (variant of ex for casual edit(l) 

effective, and saved user and/ setresuid(2) 

effective current user id whoami(l) 

effective group IDs /real user, getuid(2) 

effective user, real group, and/ getuid(2) 

effectiveness statistics csh(l) 

efficient way vfork spawn vfork(2) 

egrep, fgrep search a file for a grep(l) 

eid /enable/disable io interrupt_ctl(3I) 

electronic address router pathalias(l) 

ems Extended Memory System ems(2) 

emulate /etc/termcap access/ termcap(3X) 

emulation aterm general aterm(l) 

emulator cu call cu(l) 

enable additional device for swapon[HFS](lM) 

enable, disable enable/disable LP enable(l) 
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hpib ren ctl control the Remote 

accounting acct 
/allow interface to 

associated eid io interrupt ctl 

enable, disable 

break exit from 

breaJc exit from 

continue resume next iteration of 

crypt 

encryption crypt, setkey, 

setkey, encrypt generate hashing 

makekey generate 

in program 

loop 

/getfsfile, getfstype, setfsent, 

/getgrgid, getgmam, setgrent, 

/getpwuid, getpwnam, setpwent, 

from switch and resume after 

/getutline, pututline, setutent, 

nlist get 

man macros for formatting 

unlink remove directory 

utmp, wtmp, btmp utmp, wtmp, btmp 

get file system descriptor file 

fgetgrent get group file 

fgetpwent get password file 

utmpname access utmp file 

mknod create a special file 

putpwent write password file 

execution 

profile set up user's 

unsetenv remove variable from 

environ user 

env set 

getenv return value for 

export export variable names to 

putenv change or add value to 

setenv define 

; hpib_eoi ctl control 

remove nroff/troff", tbl, and 

newgrp 

newgrp 

mrand48, jrand48,/ drand48, 

complementary error function 

complementary error/ erf, 

last failure 



calls 

system error messages perror, 

/GETC, PEEKC, UNGETC, RETURN, 

error function erf, erfc 

error function and complementary 



Enable line on HP-IB hpib_ren_ctl(3I) 

enable or disable process acct(2) 

enable SRQ line on HP-IB hpib rqst srvce(3I) 

enable/disable interrupts for the io interrupt_ctl(3I) 

enable/disable LP printers enable(l) 

enclosing for /next loop csh(l) 

enclosing for /next loop sh(l) 

enclosing for/next loop sh(l) 

encode/decode files crypt(l) 

encrypt generate hashing crypt(3C) 

encryption crypt, crypt(3C) 

encryption key makekey(l) 

end, etext, edata last locations end(3C) 

end terminate foreach or while csh(l) 

endfsent get file system/ getfsent(3X) 

endgrent, fgetgrent get group/ getgrent(3C) 

endpwent, fgetpwent get password/ getpwent(3C) 

endsw breaksw break csh(l) 

endsw terminate switch statement csh(l) 

endutent, utmpname access utmp/ getut(3C) 

entries from name list nlist(3C) 

entries in this manual man(5) 

entry; delete file unlink(2) 

entry format utmp(4) 

entry /setfsent, endfsent getfsent(3X) 

entry /setgrent, endgrent, getgrent(3C) 

entry /setpwent, endpwent, getpwent(3C) 

entry /setutent, endutent, getut(3C) 

entry mknod(4) 

entry putpwent(3C) 

env set environment for command env(l) 

environ user environment environ(5) 

environment at login time profile(4) 

environment csh(l) 

enviromnent , environ(5) 

environment for command execution env(l) 

environment name getenv(3C) 

environment of subsequent/ sh(l) 

environment putenv(3C) 

environment variable csh(l) 

EOI mode for HP-IB file hpib_eoi_ctl(3I) 

eqn constructs deroff deroff(l) 

equivalent to exec newgrp csh(l) 

equivalent to exec newgrp sh(l) 

erand48, lrand48, nrand48, drand48(3C) 

erf, erfc error function and erf(3M) 

erfc error function and erf(3M) 

err report error information on err(l) 

errfile system error logging file errfile(4) 

errinfo error indicator errinfo(2) 

ermo error indicator for system errno(2) 

ermo, sys_errlist, sys_nerr perror(3C) 

ERROR, compile, step, advance/ regexp(5) 

error fimction and complementary erf(3M) 

error function erf, erfc erf(3M) 
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errinfo 

ermo 

err report 

decode diagnostic events from the 

diagnostic messages to form 

errfile system 

a file mkstr extract 

sys_errlist, sys_nerr system 

matherr 

spellin, hashcheck find spelling 

glob echo without '\' 

operations io timeout_ctl 

line connection dial, vmdial 

setmnt 

/tgetstr, tgoto, tputs emulate 

program end, 

hypot 

input and execute resulting/ 

input and execute resulting/ 

expression expr 

test 

if execute command if expression 

test condition 

history Display 

delog diagnost.ir 

decode read and decode diagnostic 

edit text editor (variant of 

(visual) display editor based on 

sdffsdb 

fsdb 

creating new process 

creating new process 

execlp, execvp execute a file 

execute a file execl, execv, 

execl, execv, execle, execve, 

execle, execve, execlp, execvp 

evaluates true if 

repeat 

signal trap 

new process exec 

new process exec 

construct argument list(s) 8ind 

at, batch 

is non-zero while 

opx25 

priority rtprio 

regcmp, regex compile and 

read argimients as shell input and 

read arguments as shell input and 

ignore hangups during command 

env set environment for command 

sleep suspend 

sleep suspend 

foreach continue resume 



error indicator errinfo(2) 

error indicator for system calls ermo(2) 

error information on last failure err(l) 

error log decode read and decode(lM) 

error log dmesg collect system dme8g(lM) 

error logging file errfile(4) 

error messages from C source into mkstr(l) 

error messages perror, ermo, perror(3C) 

error-handling function matherr(3M) 

errors spell, hashmake, spell(l) 

escapes csh(l) 

establish a time limit for I/O io_timeout_ctl(3I) 

establish an out-going terminal dial(3C) 

establish mount table mnttab setmnt(lM) 

/etc/termcap access routines termcap(3X) 

etext, edata last locations in end(3C) 

Euclidean distance function h)rpot(3M) 

eval read arguments as shell csh(l) 

eval read arguments as shell sh(l) 

evaluate arguments as an expr(l) 

evaluate conditional expression csh(l) 

evaluates true csh(l) 

evaluation command test(l) 

event history list csh(l) 

event logger for I/O subsystem delog(lM) 

events from the error log decode(lM) 

ex for casual users) edit(l) 

ex text editor ex(l) 

ex vi screen-oriented vi(l) 

examine/modify an SDF file system sdfFsdb(lM) 

examine/modify file system fsdb[SDF](lM) 

exec execute command without csh(l) 

exec execute command without sh(l) 

execl, execv, execle, execve, exec(2) 

execle, execve, execlp, execvp exec(2) 

execlp, execvp execute a file exec(2) 

execute a file execl, execv, exec(2) 

execute command if expression csh(l) 

execute commjind more than once csh(l) 

execute command upon receipt of sh(l) 

execute command without creating csh(l) 

execute command without creating sh(l) 

execute command xargs xargs(l) 

execute commands at a later time at(l) 

execute commands while expression csh(l) 

execute HALGOL programs opx25(lM) 

execute process with realtime rtprio(l) 

execute regular expression regcmp(3X) 

execute resulting commands eval csh(l) 

execute resulting commands eval sh(l) 

execution nohup csh(l) 

execution env(l) 

execution for an interval sleep(l) 

execution for interval sleep(3C) 

execution of nearest while or csh(l) 
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goto continue 

monitor prepare 

crtO.o, mcrtO.o, frtO.o, mfrtO.o 

profil 

system to UNIX system command 

uuxqt uucp command 

execvp execute a file execl, 

file execl, execv, execle, 

execv, execle, execve, execlp, 

calls link, unlink 

tunefs time up an 

create a new file or rewrite an 



break 

break 

return 

exit 

exit 

exit exit shell with 

exit exit shell with 

exit, 

exponential, logarithm, power,/ 

imcompress, zcat compress and 

pack, peat, unpack compress and 

versa expand, imexpand 

spaces, and vice versa 

floating-point into mantissa and 

exp, log, loglO, pow, sqrt 

environment of subsequent/ 

environment of subsequent/ export 

expression 

/compile, step, advance regular 

test evaluate conditional 

if execute conrnismd if 

expr evaluate arguments as an 

while execute commands while 

regex compile and execute regular 

ems 

file rmnl remove 

source into a file mkstr 

basename, dirname 

absolute/ floor, ceil, fmod, 

sigvector software signal 

inter-process communication 

primes factor, primes 

generate large primes 

report error information on last 

true, 

data in a machine-independent 

prealloc preallocate 

/calloc, mallopt, mallinfo 

fixman fix manual pages for 



execution on specified line csh(l) 

execution profile monitor(3C) 

execution startup routines crtO(3) 

execution time profile profil(2) 

execution uux UNIX uux(l) 

execution uuxqt(lM) 

execv, execle, execve, execlp, exec(2) 

execve, execlp, execvp execute a exec(2) 

execvp execute a file execl, exec(2) 

exercise link and unlink system link(lM) 

existing file system timefs[HFS](lM) 

existing one creat creat(2) 

exit exit shell with exit status csh(l) 

exit exit shell with exit status sli(l) 

exit, _exit terminate process exit(2) 

exit from enclosing for/next loop csh(l) 

exit from enclosing for/next loop sh(l) 

exit fimction with return value sh(l) 

exit shell with exit status csh(l) 

exit shell with exit status sb(l) 

exit status csh(l) 

exit status sh(l) 

_exit terminate process exit(2) 

exp, log, loglO, pow, sqrt exp(3M) 

expand data compress, compress(l) 

expand files pack(l) 

expand tabs to spaces, and vice expand(l) 

expand, imexpand expand tabs to expand(l) 

exponent /Idexp, modf split frexp(3C) 

exponentifil, logarithm, power,/ exp(3M) 

export export variable names to sh(l) 

export variable names to ^^(1) 

expr evaluate arguments as an expr(l) 

expression compile and match/ regexp(5) 

expression csh(l) 

expression evaluates true csh(l) 

expression expr(l) 

expression is non-zero csh(l) 

expression regcmp, regcmp(3X) 

Extended Memory System ems(2) 

extra new-line characters from rmnl(l) 

extract error messages from C mkstr(l) 

extract portions of path names basename(l) 

f77, fc FORTRAN 77 compiler f77(l) 

fabs floor, ceiling, remainder, floor(3M) 

feicilities sigvector(2) 

facilities status ipcs report ipcs(l) 

factor a number, generate large factor(l) 

factor, primes factor a number, factor(l) 

failure err err(l) 

false provide truth values true(l) 

ffishion /access long integer sputl(3X) 

fast disk storage prealloc(2) 

fast main memory allocator malloc(3X) 

faster viewing with man(l) fixman(l) 
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abort generate an lOT 

io_on interrupt device interrupt 

newgrp equivalent to 

newgrp equivalent to 

f77, 

chmod, 

a file chown, 

stream 



floating-point number to/ ecvt, 

symbolic debugger cdb, 

flip; convert/ fopen, freopen, 

status inquiries ferror, 

streai^ statu? inquiries 

head give first 

fclose, 

from a stream/ getc, getchar, 

/getgmam, setgrent, endgrent, 

/getpwnam, setpwent, endpwent, 

gets, 

grep, egrep, 

to left shift shift 

cut cut out selected 

mknod create special and 

afi asynchronous 

times utime set 

determine accessibility of a 

tar tape 

cpio copy 

bifchmod change mode of a BIF 

pwck, grpck password/group 

fchmod change access mode of 

change owner and group of a 

difl', diffh differential 

diffS 3-way differential 

fcntl 

fcntl 

/fdopen open or re-open a stream 

public UNIX system to UNIX system 

core format of core image 

umask set and get 

crontab user crontab 

ctags create a tags 

selected fields of each line of a 

translate, and copy a (tape) 

make a delta (change) to an SCCS 

close close a 

dup duplicate an open 

slot dup2 duplicate an open 

disktab disk description 

sact print current SCCS 

get file system descriptor 

endgrent, fgetgrent get group 



fault abort(3C) 

(fault) control io_on interrupt(3I) 

exec newgrp , csh(l) 

exec newgrp sh(l) 

fc FORTRAN 77 compiler f77(l) 

fchmpd change access mode of file chmod(2) 

fchown change owner and group of chown(2) 

fclose, flBuSh close or flush a fclose(3S) 

fcntl file control fcntl(2) 

fcntl file control options fcntl(5) 

fcvt, gcvt, nl gcvt convert ecvt(3C) 

fdb, pdb C, FORTRAN, Pascal cdb(l) 

fdopen open or re-open a stream fopen(3S) 

feof, clearerr, fileno stream ferror(3S) 

ferror, feof, clearerr, fileno ferror(3S) 

few lines head(l) 

fflush close or flush a stream fclose(3S) 

■ fgetc, getw, get character or word getc(3S) 

fgetgrent get group file entry getgrent(3C) 

fgetpwent get password file entry getpwent(3C) 

fgets get a string from a stream gets(3S) 

fgrep search a file for a pattern ,.. grep(l) 

argv members one position csh(l) 

fields of each line of a file , cut(l) 

fifo files ■ mknod(lM) 

FIFO interface . gpio(7) 

file access and modification utime(2) 

file access access(2) 

file archiver tar(l) 

file archives in and out cpio(l) 

file bifchmod(l) 

file checkers pwck(lM) 

file chmod, chmod(2) 

file chown, fchown chown(2) 

file comparator diff(l) 

file comparison diff3(l) 

file control fcntl(2) 

file control options fcntl(5) 

file; convert -file to stream fopen(3S) 

file copy uuto, uupick uuto(l) 

file , core(4) 

file creation mask umask(2) 

file crontab(l) 

file ctags(l) 

file cut cut out cut(l) 

file dd convert, reblock, dd(l) 

file delta delta(l) 

file descriptor ...., close(2) 

file descriptor dup(2) 

file descriptor to a specific dup2(2) 

file determine file type file(l) 

file disktab[HFS](4) 

file editing activity sact(l) 

fije entry /setfsent, endfsent getfsent(3X) 

file entry /getgmam, setgrent, getgrent(3C) 
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endpwent, fgetpwent get password 

endutent, utmpnarac access utmp 

mknod create a special 

putpwent write password 

errfile system error logging 

execve, execlp, execvp execute a 

grep, egrep, fgrep search a 

dumpmsg create message catalog 

open open 

acct per-process accounting 

ar common archive 

binary input/output to a stream 

a formatted message catalog 

get get a version of an SCCS 

character or word from a stream 

group group 

control EOI mode for HP-IB 

(csh(l)/ which locate a program 

split split a 

termination character on special 

issue issue identification 

write LIF volume header on 

lifrm remove a LIF 

linkinfo object 

link link to a 

Issf list a special 

mkdir make a directory 

or a special or ordinary 

mksf make a special 

messages from C source into a 

ctermid generate 

mktemp make a unique 

newform change or reformat a text 

list (symbol table) of object 

null null 

insf, mksf, Issf devices 

ttyslot find the slot in the utmp 

1 creat create a new 

bifchown, bifchgrp change 

chown, chgrp change 

buifered input/output stream 

files or subsequent lines of one 

viewing more, page 

terminals pg 

fseek, rewind, ftell reposition a 

Iseek move read/write 

prs print and summarize an SCCS 

passwd password 

rev reverse lines of a 

rmdel remove a delta from an SCCS 

rmdir remove a directory 

extra new-line characters from 

conversion, read from stream 

bfs big 

compare two versions of an SCCS 



file entry /getpwnam, setpwent, getpwent(3C) 

file entry /puiutiine, setutent, getut(3C) 

file entry mknod(4) 

file entry putpwent(3C) 

file errfile(4) 

file execl, execv, execle, exec(2) 

file for a pattern '. grep(l) 

file for modification findmsg, findmsg(l) 

file for reading or writing open(2) 

file format acct(4) 

file format ar(4) 

file fread, fwrite buffered fread(3S) 

file gencat generate ,..,..... gencat(l) 

file get(l) 

file /getchar, fgetc, getw get getc(3S) 

file, grp.h .' group(4) 

file hpib_eoi ctl hpib eoi ctl(3I) 

file including aliases and paths which(l) 

file into pieces split(l) 

file io_eoL_ctl set up read io_eol_ctl(3I) 

file ..; issue(4) 

file lifinit lifinit(l) 

file lifrm(l) 

file link information utility linkinfo(l) 

file link(2) 

file Issf(l) 

file mkdir(2) 

file mknod make a directory, mknod(2) 

file mksf(l) 

file mkstr extract error inkstr(l) 

file name for terminal ctermid(3S) 

file name mktemp(3C) 

file newform(l) 

file nm print name nm(l) 

file null(7) 

file of driver information for devices(4) 

file of the current user ttyslot(3C) 

file or rewrite an existing one creat(2) 

file owner or group bifchown(l) 

file owner or group chown(l) 

file package stdio standard stdio(3S) 

file /met-ge same lines of several paste(l) 

file perusal filter for crt more(l) 

file perusal filter for soft-copy Pg(l) 

file pointer in a stream fseek(3S) 

file pointer; seek lseek(2) 

file prs(l) 

file, pwd.h passwd(4) 

file rev(l) 

file rmdel(l) 

file rmdir(2) 

file rmnl remove rmnl(l) 

file /sscanf formatted input scanf(3S) 

file scanner bfs(l) 

file sccsdiff' sccsdiff(l) 
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sccsfile format, of sees file sccsfile(4) 

sdfchmod change mode of an SDF file sdfchmod(l) 

change owner or group of an SDF file sdfchown, sdfchgrp sdfchown(l) 

assign buffering to a stream file setbuf, setvbuf setbuf(3S) 

processes ulimit impose file size limit for child sh(l) 

Stat, fstat get file status stat(2) 

in a object, or other binary, file /find the printable strings strings(l) 

checksum and block coimt of a file sum print s\mi(l) 

autobkup backup or archive file system autobkup(lM) 

backup backup or archive file system backup(lM) 

bifmkfs construct a Bell file system bitinkfs(lM) 

interactive repair bififsck Bell file system consistency check and bifFsck(lM) 

interactive repair fsck file system consistency check and fsck[HFS](lM) 

interactive repair fsck file system consistency check and fsck[SDF](lM) 

interactive repair sdffsck SDF file system consistency check, sdffsck(lM) 

bilFsdb Bell file system debugger biffsdb(lM) 

fsdb file system debugger fsdb[HFS](lM) 

/getfstype, setfsent, endfsent get file system descriptor file entry getfsent(3X) 

shutdown status of specified file system fsclean determine fsclean(lM) 

fsdb examine/modify file system f8db[SDF](lM) 

hier file system hierarchy hier(5) 

syncer periodically sync for file system integrity syncer(lM) 

mkfs construct a file system mkfs[HFS](lM) 

uiuuui lUUuuL a uic syatciii mOUnT^y^Jy 

moiuit, umount moimt and dismoimt file system mount [HFS](1M) 

mount, vunoimt mount and unmoimt file system mount[non-HFS](lM) 

newfs construct a new file system newfs[HFS](lM) 

sdffsdb examine/modify an SDF file system sdffsdb(lM) 

ustat get file system statistics ustat(2) 

nmttab mounted file system table mnttab(4) 

timefs tune up an existing file system tunefs[HFS](lM) 

tmioimt urunount a file system imioimt(2) 

fs format of file system volume fs(HFS](4) 

static information about the file systems checklist checklist(4) 

tail deliver the last part of a file tail(l) 

term format of compiled term file term(4) 

tmpfile create a temporary file tmpfile(3S) 

create a name for a temporary file tmpnam, tempnam tmpnam(3S) 

truncate, ftruncate tnmcate a file to a specified length truncate(2) 

or re-open a stream file; convert file to stream /fdopen open fopen(3S) 

and/or change times of file /access, modification, touch(l) 

kermit KERMIT-protocol file transfer program kermit(l) 

umodem XMODEM-protocol file transfer program umodem(l) 

ftw walk a file tree ftw(3C) 

file determine file type file(l) 

imdo a previous get of an SCCS file unget imget(l) 

imiq report repeated lines in a file uniq(l) 

remove directory entry; delete file unlink imlink(2) 

val validate SCCS file val(l) 

make tmprintable characters in a file visible or invisible /inv vis(l) 

write, writev write on a file write(2) 

umask set file-creation mode mask luiiask(l) 

alias substitute command and/or filename csh(l) 

ferror, feof, clearerr, fileno stream status inquiries ferror(3S) 

and print process accounting file(s) acctcom search acctcom(l) 
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merge or add total accounting 

admin create and administer SCCS 

ccat compress and imcompress 

bifcp copy to or from BIF 

cat concatenate, copy, and print 

cmp compare two 

reject lines common to two sorted 

cp, In, mv copy, link or move 

crypt encode/decode 

permissions mask for creating new 

diffink mark differences between 

find find 

what identify 

catman create the cat 

format specification in text 

biifind find 

sdfiind find 

cpset install object 

state on/ feync synchronize a 

insf install special 

lifcp copy to or from LIF 

lifrename rename LIF 

semaphores and record locking on 

mkdev make device 

mknod create special and fifo 

bifrm, bifrmdir remove BIF 

nn, rmdir remove 

sdfrm, sdfrmdir remove SDF 

paste merge same lines of several 

peat, unpack compress and expand 

pr print 

revision niunbers of HP-UX 

permissions mask for creating new 

print section sizes of object 

sort sort and/or merge 

/sdfln, sdfmv copy, link, or move 

more, page file perusal 

pg file perusal 

nl line niunbering 

backspaces col 

type show interpretation of 

readonly mark 

find 

biffind 

sdffind 

hyphen 

kej^words; print out the/ man 

ttyname, isatty 

object library lorder 

hashmake, spellin, hashcheck 

message catalogs findstr 

object, or other binary,/ strings 

the current user ttyslot 

catalog file for modification 



files acctmerg acctmerg(lM) 

files admin(l) 

files, and cat them /uncompact, compact(l) 

files bifcp(l) 

files cat(l) 

files cmp(l) 

files comm select or comm(l) 

files cp(l) 

files crypt(l) 

files umask set csh(l) 

files diffmk(l) 

files find(l) 

files for SCCS information what(l) 

files for the manual catman(lM) 

files fspec fspec(4) 

files in a BIF system biflBnd(l) 

files in an SDF system sdlfind(l) 

files in binary directories cpset(lM) 

file's in-core state with its fsync(2) 

files insf(l) 

files lifcp(l) 

files lifrename(l) 

files lockf provide lockf(2) 

files mkdev(lM) 

files mknod(lM) 

files or directories bifnn(l) 

files or directories rm(l) 

files or directories sdfrm(l) 

files or subsequent lines of one/ paste(l) 

files pack, pack(l) 

files pK^) 

files revck check internal revck(lM) 

files umask set sh(l) 

files size size(l) 

files sort(l) 

files to/from an SDF volume sdfcp(l) 

filter for crt viewing more(l) 

filter for soft-copy terminals Pg(l) 

filter nl(l) 

filter reverse line-feeds and col(l) 

name as if a command sh(l) 

name as read-only sh(l) 

find files find(l) 

find files in a BIF system biffind(l) 

find files in an SDF system sdflBnd(l) 

find find files find(l) 

find hyphenated words hyphen(l) 

find manual information by man(l) 

find name of a terminal ttyname(3C) 

find ordering relation for an lorder(l) 

find spelling errors spell, spell(l) 

find strings for inclusion in findstr(l) 

find the printable strings in a strings(l) 

find the slot in the utmp file of ttyslot (3C) 

findmsg, dmnpmsg create message findmsg(l) 
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inclusion in message catalogs 

to getmsg(3C) insertmsg use 

fold fold long lines for 

tee pipe 

viewing with man(l) fixman 

faster viewing with man(l) 

set set/define 

remove definition/setting of 

set set/define 

remove definition/setting of 

mediainit initialize hard disk, 

cvtnum convert string to 

frexp, Idexp, modf split 

ecvt, fcvt, gcvt, nl gcvt convert 

ceiling, remainder, absolute/ 

absolute/ floor, ceil, fmod, fabs 

cflow generate C 

fclose, fflush close or 

remainder, absolute/ floor, ceil, 

width output device 

output device fold 

re-open a stream file; convert/ 

execution of nearest while or 

end terminate 

system diagnostic messages to 

acct per-process accoimting file 

ar common archive file 

arcv convert archives to new 

lif logical interchange 

sdf structured directory 

ranlib archive symbol table 

nroff neqn 

nlist nlist structure 

nlist nlist structure 

inode 

inode 

term 

core 

cpio 

dir 

dir 

fs 

privgrp 

sccsfile 

fs 

files fspec 

tbl 

nroff 

bif bell interchange 

wtmp, btmp utmp, wtmp, btmp entry 

initialize Structured Directory 

from/ scanf, fscanf, sscanf 

gencat generate a 



findstr find strings for findstr(l) 

findstr(l) output to insert calls insertmsg(l) 

finite width output device fold(l) 

fitting tee(l) 

fix manual pages for faster fixman(l) 

fixman fix manual pages for fixman(l) 

flags and arguments csh(l) 

flags and arguments unset csh(l) 

flags and arguments sh(l) 

flags £ind arguments unset sh(l) 

flexible disk, or cartridge tape/ mediainit(l) 

floating point number cvtnum(3C) 

floating-point into mantissa and/ frexp(3C) 

floating-point number to string ecvt(3C) 

floor, ceil, fmod, fabs floor, floor(3M) 

floor, ceiling, remainder, floor(3M) 

flow graph cflow(l) 

flush a stre£im fclose(3S) 

fmod, fabs floor, ceiling, floor(3M) 

fold fold long lines for finite fold(l) 

fold long lines for finite width fold(l) 

fopen, freopen, fdopen open or fopen(3S) 

foreach continue resume csh(l) 

foreach initiate repetitive loop csh(l) 

foreach or while loop csh(l) 

fork create a new process fork(2) 

form error log dmesg collect dmesg(lM) 

format acct(4) 

format ar(4) 

format arcv(l) 

format description lif(4) 

format description sdf(4) 

format for object libraries ranlib(4) 

format mathematical text for neqn(l) 

format nlist(4) 

format nlist(4) 

format of an inode inode[HFS](4) 

format of an i-node inode[SDF](4) 

format of compiled term file term(4) 

format of core image file core(4) 

format of cpio archive cpio(4) 

format of directories dir(4) 

format of directories dir[HFS](4) 

format of file system volume fs[HFS](4) 

format of privileged values privgrp(4) 

format of sees file sccsfile(4) 

format of system volume fs[SDF](4) 

format specification in text fspec(4) 

format tables for nroff tbl(l) 

format text nroff(l) 

format utilities bif(4) 

format utmp, utmp(4) 

Format volume sdfinit sdfinit[SDF](lM) 

formatted input conversion, read scanf(3S) 

formatted message catalog file gencat(l) 
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vprintf, vfprintf , vsprintf print 

printf, fprintf, sprintf print 

/fprintmsg, sprintmsg print 

mm, osdd print/check docmnents 

adjust simple text 

cb C program beautifier, 

mm the MM macro package for 

man macros for 

break exit from enclosing 

break exit from enclosing 

next iteration of enclosing 

f77, fc 

ratfor rational 

cdb, fdb, pdb C, 

output printf, 

formatted output with/ printmsg, 

on a stream putc, putchar, 

puts, 

input/output to a stream file 

memallc, memfree allocate and 

bifdf report number of 

df report number of 

allocator malloc, 

maJlinfo fast main/ malloc, 

sdfdf report number of 

stream file; convert file/ fopen, 

floating-point into mantissa and/ 

from who is my mail 

startup/ crtO.o, mcrtO.o, 



conversion, read from/ scanf, 

check and interactive repair 

check and interactive repair 

of specified file system 



file pointer in a stream 

text files 

stat, 

in-core state with its state on/ 

in a stream fseek, rewind, 

precisely 

communication package 

specified length truncate, 

fimction erf, erfc error 

function and complementary error 

gamma, signgam log gamma 

hypot Euclidean distance 

matherr error-handling 

prof profile within a 

return exit 

math math 

jO, jl, jn, yO, yl, yn Bessel 



formatted output of a varargs/ vprintf(3S) 

formatted output printf(3S) 

formatted output with mmibered/ printmsg(3C) 

formatted with the MM macros mm(l) 

formatter adjust(l) 

formatter cb(l) 

formatting documents mm(5) 

formatting entries in this manual man(5) 

for /next loop csh(l) 

for/next loop sh(l) 

for /next loop continue resume sh(l) 

FORTRAN 77 compiler f77(l) 

Fortran dialect ratfor(l) 

FORTRAN, Pascal symbolic debugger ... cdb(l) 

fprintf, sprintf print formatted printf(3S) 

fprintmsg, sprintmsg print printmsg(3C) 

fputc, putw put character or word putc(3S) 

^uts put a string on a stream puts(3S) 

fread, fwrite buflFered binary fread(3S) 

free address space memallc(2) 

free disk blocks bifdf(lM) 

free disk blocks df(lM) 

free, realloc, calloc main memory malloc(3C) 

free, realloc, calloc, mallopt, malloc(3X) 

free SDF disk blocks sdfdf(lM) 

freopen, fdopen open or re-open a fopen(3S) 

frexp, Idexp, modf split frexp(3C) 

from? from(l) 

frtO.o, mfrtO.o execution crt0(3) 

fs format of file system volume fs[HFS](4) 

fs format of system volume fs[SDF](4) 

fscanf, sscanf formatted input scanf (3S) 

fsck file system consistency fsck[HFS](lM) 

fsck file system consistency fsck[SDF](lM) 

fsclean determine shutdown status fsclean(lM) 

fsdb examine/modify file system fsdb[SDF](lM) 

fsdb file system debugger fsdb[HFS](lM) 

fseek, rewind, ftell reposition a fseek (3S) 

fspec format specification in fspec(4) 

fstat get file status stat(2) 

fsync synchronize a file's fsync(2) 

ftell reposition a file pointer fseek(3S) 

ftime get date and time more ftime(2) 

ftok standard interprocess stdipc(3C) 

ftruncate truncate a file to a truncate(2) 

ftw walk a file tree ftw(3C) 

function and complementary error erf(3M) 

function erf, erfc error erf(3M) 

function gamma(3M) 

function hypot(3M) 

function matherr(3M) 

function prof(5) 

function with return value sh(l) 

functions and constants math(5) 

functions bessel(3M) 
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logarithm, power, square root 

remainder, absolute value 

2621-series/ hp handle special 

sinh, cosh, tanh hyperbolic 

acos, atan, atan2 trigonometric 

input/output to a stream/ fread, 

accoimting records 

gamma, signgam log 

floating-point/ ecvt, fcvt, 

message catalog file 

terminal emulation aterm 

termio 

catalog file gencat 

abort 

cflow 

cross-reference cxref 

user ID diskusg 

makekey 

ctermid 

crypt, setkey, encrypt 

factor, primes factor a number, 

ncheck 

analysis of text lex 

/jrand48, srand48, seed48, lcong48 

rand, srand simple random-nmnber 

ioctl 

character or word from a stream/ 

ERROR, compile, step,/ INIT, 

character or word from a/ getc, 

working directory 

user,/ getuid, geteuid, getgid, 

environment name 

user, effective user,/ getuid, 

getfstype, setfsent, endfsent/ 

endfsent/ getfsent, getfsspec, 

setfsent, endfsent get/ getfeent, 

getfsent, getfsspec, getfsfile, 

effective user,/ getuid, geteuid, 

setgrent, endgrent, fgetgrent/ 

endgrent, fgetgrent/ getgrent, 

fgetgrent/ getgrent, getgrgid, 

host 
value of interval timer 



output to insert calls to 
get option letter from argument/ 



process, process group,/ getpid, 

group,/ getpid, getpgrp, getppid, 

getpgrp2 get process, process/ 

process group,/ getpid, getpgrp. 



functions /pow, sqrt exponential, exp(3M) 

functions /fabs floor, ceiling, floor(3M) 

functions of HP 2640 and hp(l) 

functions sinh(3M) 

functions sin, cos, tan, asin, trig(3M) 

fwrite buffered binary fread(3S) 

fwtmp, wtmpfix manipulate connect fwtmp(lM) 

gamma function gamma(3M) 

gamma, signgam log gamma function gamma(3M) 

gcvt, nl gcvt convert ecvt(3C) 

gencat generate a formatted gencat(l) 

general purpose asynchronous aterm(l) 

general terminal interface termio(7) 

generate a formatted message gencat(l) 

generate an lOT fault abort(3C) 

generate C flow graph cflow(l) 

generate C program cxref(l) 

generate disk accoimting data by diskusg(lM) 

generate encryption key makekey(l) 

generate file name for terminal ctermid(3S) 

generate hashing encryption crypt (3C) 

generate large primes factor(l) 

generate names from i-numbers ncheck[non-SDF](lM) 

generate programs for lexical lex(l) 

generate imiformly distributed/ drand48(3C) 

generator rand(3C) 

generic device control commands ioctl(5) 

getc, getchar, fgetc, getw get getc(3S) 

GETC, PEEKC, UNGETC, RETURN, . regexp(5) 

getchar, fgetc, getw get getc(3S) 

getcwd get path-name of ciu-rent getcwd(3C) 

getegid get real user, effective getuid(2) 

getenv return value for getenv(3C) 

geteuid, getgid, getegid get real getuid(2) 

getfsent, getfsspec, getfsfile, getfsent(3X) 

getfsfile, getfstype, setfsent, getfsent (3X) 

getfespec, getfsfile, getfstype, getfsent(3X) 

getfstype, setfsent, endfsent get/ getfsent(3X) 

getgid, getegid get real user, getuid(2) 

getgrent, getgrgid, getgmam, getgrent(3C) 

getgrgid, getgmam, setgrent, getgrent(3C) 

getgmam, setgrent, endgrent, getgrent(3C) 

getgroups get group access list getgroups(2) 

gethostname get name of current gethostname(2) 

getitimer, setitimer get/set getitimer(2) 

getlogin get login name getlogin(3C) 

getmsg get message from a catalog getmsg(3C) 

getmsg(3C) /use find8tr(l) insertmsg(l) 

getopt, optarg, optind, opterr getopt(3C) 

getopt parse command options getopt(l) 

getpass read a password getpass(3C) 

getpgrp, getppid, getpgrp2 get getpid(2) 

getpgrp2 get process, process getpid(2) 

getpid, getpgrp, getppid, getpid(2) 

getppid, getpgrp2 get process, getpid(2) 
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for group 
set special attributes for group 

setpwent, endpwent, fgetpwent/ 

fgetpwent/ getpwent, getpwuid, 

endpwent, fgetpwent/ getpwent, 

stream 

gettimeofday, settimeofday 

getitimer, setitimer 

get/set date and time 

8j)eed, and line discipline 

and terminal settings used by 

terminal) ct spawn 

settings used by getty 

get real user, effective user,/ 

pututline, setutent, endutent,/ 

setutent, endutent,/ getutent, 

endutent,/ getutent, getutid, 

stream/ getc, getchar, fgetc, 

head 
on user's native language as 

ctime, nl_ctime, localtime, 

specified line 

setjmp, longjmp non-local 

return status lines of 

gpio_set ctl set control lines on 

lines of GPIO card 

GPIO card 

cflow generate C flow 

information for CRT 

CRT graphics/ CRT 

for a pattern 

getgroups get 

initgroups initialize 

setgroups set 

./real user, effective user, real 

/getpgrp2 get process, process 

bifchgrp change file owner or 

chown, chgrp change file owner or 

setgrent, endgrent, fgetgrent get 

group 

get special attributes for 

and set special attributes for 

setpgrp, setpgrp2 set process 

id print user and 

user, real group, and effective 

effective, and saved user and 

setuid, setgid set user and 

groups show 

newgrp log in to a new 

chown, fchown change owner and 

sdfchgrp change owner or 



getprivgrp get special attributes getprivgrp(l) 

getprivgrp, setprivgrp get and getprivgrp(2) 

getpw get name from UID =„..=,=====„...„. getpw(3C) 

getpwent, getpwuid, getpwnam, getpwent(3C) 

getpwnam, setpwent, endpwent, getpwent(3C) 

getpwuid, getpwnam, setpwent, getpwent(3C) 

gets, fgets get a string from a gets(3S) 

get/set date and time gettimeofday(2) 

get /set value of interval timer getitimer (2) 

gettimeofday, settimeofday gettimeofday(2) 

getty set terminal type, modes, getty(lM) 

getty gettydefs speed gettydefs(4) 

getty to a remote terminal (call ct(l) 

gettydefs speed and terminal gettydefs(4) 

getuid, geteuid, getgid, getegid getuid(2) 

getutent, getutid, getutline, getut(3C) 

getutid, getutline, pututline, getut(3C) 

getutline, pututline, setutent, getut(3C) 

getw get character or word from a getc(3S) 

getx25 get x25 line getx25(lM) 

give first few lines head(l) 

given by NLS /information langinfo(3C) 

glob echo without '\' escapes csh(l) 

gmtime, asctime, nl_asctime,/ ctime(3C) 

goto continue execution on csh(l) 

goto setjmp(3C) 

GPIO card gpio_get_status gpio_get_status(3I) 

GPIO card gpio__set_ctl(3I) 

gpio_get_Jstatus return status gpio_get_status(3I) 

gpio^set_ctl set control lines on gpio_set_ctl(3I) 

graph cflow(l) 

graphics devices /graphics graphics(7) 

graphics information for graphics(7) 

grep, egrep, fgrep search a file grep(l) 

group access list getgroups(2) 

group access list initgroups(3C) 

group access list setgroups(2) 

group, and effective group IDs getuid(2) 

group, and parent process ID getpid(2) 

group bifchown, bifchown(l) 

group chown(l) 

group file entry /getgmam, getgrent(3C) 

group file, grp.h group(4) 

group getprivgrp getprivgrp(l) 

group getprivgrp, setprivgrp get getprivgrp(2) 

group group file, grp.h group(4) 

group ID setpgrp(2) 

group IDs and names id(l) 

group IDs /real user, effective getuid(2) 

group IDs /setresgid set real, setresuid(2) 

group IDs setuid(2) 

group memberships groups(l) 

group newgrp(l) 

group of a file chown(2) 

group of an SDF file sdfchown, sdfchown(l) 
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send a gignal to a process or a 

set special attributes for 

list spooled uucp transactions 

maintain, update, and regenerate 

checkers pwck, 

group group file, 

ssignal, 

stty, 

opx25 execute 

2640 and 2621-series/ hp 

varargs 

disable/enable integer trap 

curses CRT screen 

nohup ignore 

nohup run a command immune to 

cartridge/ mediainit initialize 

trapno 

search path 

hsearch, hcreate, hdestroy manage 

rehash recompute internal 

statistics hashstat print 

unhash disable use of internal 

spell, hashmake, spellin, 

crypt, setkey, encrypt generate 

spelling errors spell, 

effectiveness statistics 

search tables hsearch, 

tables hsearch, hcreate, 

lifinit write LIF volume 

help ask for 

driver hpib 

od, xd octal and 

hier file system 

list 

history Display event 

sethostname set pame of 

gethostname get name of current 

set or print name of current 

current host system 

hp handle special functions of 

2640 and 2621-series terminals 

upm unpack cpio archives from 

Model hpnls 

hp9000s500, hp9000s800, pdpll,/ 

hp9000s800, pdpll,/ hp9000s200, 

u3b,/ hp9000s200, hp9000s300, 

provide/ /hp9000s300, hp9000s500, 

stop activity on specified 

conduct parallel poll on 

conduct a serial poll on 

hpib_io perform I/O with an 



group of processes kill kill(2) 

group setprivgrp setprivgrp(lM) 

grouped by transaction uuls uuls(lM) 

groups of programs make make(l) 

groups show group memberships groups(l) 

grpck password/group file pwck(lM) 

grp.h group(4) 

gsignal software signals ssignal(3C) 

gtty control device stty(2) 

HALGOL programs opx25(lM) 

handle special functions of HP hp(l) 

handle variable argument list varargs(5) 

hfindler intrapoff, intrapon » intrapoflF(3m) 

handUng and optimization package curses(3X) 

hangups during command execution csh(l) 

hangups, logouts, and quits nohup(l) 

hard disk, flexible disk, or mediainit(l) 

hardware trap numbers trapno(2) 

hash remember command location in sh(l) 

hash search tables hsearch(3C) 

hash table ; , csh(l) 

hash table effectiveness csh(l) 

hash tables csh(l) 

hashcheck find spelling errors spell (1) 

hashing encryption crypt(3C) 

hashmake, spellin, hashcheck find spell(l) 

hashstat print hash table ; csh(l) 

hcreate, hdestroy manage hash hsearch(3C) 

hdestroy manage hash search hsearch(3C) 

head give first few lines head(l) 

header on file lifinit(l) 

help ask for help help(l) 

help help(l) 

Hewlett-Packard Interface Bus hpib(7) 

hexadecimal drnnp od(l) 

hier file system hierarchy hier(5) 

hierarchy hier(5) 

history Display event history csh(l) 

history list csh(l) 

host cpu sethostname(2) 

host gethostname(2) 

host system hostname hostname(l) 

hostname set or print name of hostname(l) 

HP 2640 and 2621-series terminals hp(l) 

hp handle special functions of HP hp(l) 

HP media upm(l) 

HP Native Language Support (NLS) hpnls(5) 

hp9000s200, hp9000s300, machid(l) 

hp9000s300, hp9000s500, machid(l) 

hp9000s500, hp9000s800, pdpll, machid(l) 

hp9000s800, pdpll, u3b, u3b5, vax machid(l) 

HP-IB bus hpib_abort hpib_abort(3I) 

HP-IB bus hpib_ppoll hpib_ppoll(3I) 

HP-IB bus hpib_spoll hpib_^poll(3I) 

HP-IB channel from buff"ers hpib io(3I) 
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hpib_eoi_ctl control EOI mode for 

Bus diiver 

response to parallel poll on 

change active controllers on 

control the Remote Enable line on 

interface to enable SRQ line on 

send command bytes over 

hpib_bus_^tatus return status of 

specified HP-IB bus 

HP-IB interface 

response to parallel poll on/ 

hpidelete, hpiend, hpierror,/ 3X 

HP-IB file 

channel from buffers 

controllers on HP-IB 

on HP-IB bus 

interface parallel poll response 

Enable line on HP-IB 

to enable SRQ line on HP-IB 

over HP-IB 

on HP-IB bus 

requested status condition/ 

particular parallel poll value/ 

hpiend, hpierror,/ 3X hpibegin, 

hpierror,/ 3X hpibegin, hpiclose, 

hpibegin, hpiclose, hpicontrol, 

/hpiclose, hpicontrol, hpidelete, 

/hpicontrol, hpidelete, hpiend, 

/hpidelete, hpiend, hpierror, 

/hpiend, hpierror, hpifind, 

/hpierror, hpifind, hpifindset, 

/hpifind, hpifindset, hpiget, 

/hpifindset, hpiget, hpiinfo, 

interactive/ iquery ALLBASE/HP-UX 

hpiutil ALLBASE/HP-UX 

/hpiget, hpiinfo, hpilock, 

/hpiinfo, hpilock, hpimemo, 

/hpilock, hpimemo, hpiopen, 

/hpimemo, hpiopen, hpiput, 

/hpiopen, hpiput, hpiundo, 

database utilities 

(NLS) Model 

utility hpux 

internal revision numbers of 

installation utility 

magic magic numbers for 

model 

sysrm remove optional 

update update optional 

revision get 

rootmark mark/uimiark volume as 

reconfig configure an 

imame print name of current 

hash search tables 

sinh, cosh, tanh 



HP-IB file hpib_eoi_ctl(3I) 

hpib Hewlett-Packard Interface hpib(7) 

HP-IB /control hpib_card ppoll resp(3I) 

HP-IB hpib_t)ass_ctl hpib_pass_ctl(3I) 

HP-IB hpib__ren_ctl hpib_ren_ctl(3I) 

HP-IB hpib__rqst_jrvce allow hpib__rqst_srvce(3I) 

HP-IB hpib_send cmnd hpib_jsend cmnd(3I) 

HP-IB interface *. hpib_bus_status(3I) 

hpib abort stop activity on hpib abort(3I) 

hpib_bus status return status of hpib_bus status(3I) 

hpib_card ppoll resp control 'hpib—card ^ppoll resp(3I) 

hpibegin, hpiclose, hpicontrol, hpimage 

hpib_eoi_ctl control EOI mode for hpib_eoi ctl(3I) 

hpib_jo perform I/O with an HP-IB hpib_io(3I) 

hpib_pass_ctl change active hpib_pass_ctl(3I) 

hpib_ppoll conduct parallel poll hpib_ppoll(3I) 

hpib__ppol] resp_ctl Define hpib_ppoll resp_ctl(3I) 

hpib ren ctl control the Remote hpib__ren ctl(3I) 

hpib rqst srvce allow interface hpib rqst srvce(3I) 

hpib_send cmnd send command bytes . hpib send cmnd(3I) 

hpib spoil conduct a serial poll hpib_spoll(3I) 

hpib_jstatus_wait wait until the hpib status_wait(3I) 

hpib_wait__on ppoll wait until a hpib_wait_on ppoll(3I) 

hpiclose, hpicontrol, hpidelete, hpimage 

hpicontrol, hpidelete, hpiend, hpimage 

hpidelete, hpiend, hpierror,/ 3X hpimage 

hpiend, hpierror, hpifind,/ hpimage 

hpierror, hpifind, hpifindset,/ hpimage 

hpifind, hpifindset, hpiget,/ hpimage 

hpifindset, hpiget, hpiinfo,/ hpimage 

hpiget, hpiinfo, hpilock,/ hpimage 

hpiinfo, hpilock, hpimemo,/ hpimage 

hpilock, hpimemo, hpiopen,/ hpimage 

HPIMAGE database access iquery(l) 

HPIMAGE database utilities hpiutil(l) 

hpimemo, hpiopen, hpiput,/ hpimage 

hpiopen, hpiput, hpiundo,/ hpimage 

hpiput, hpiundo, hpiupdate,/ hpimage 

hpiundo, hpiupdate, chpibegin,/ hpimage 

hpiupdate, chpibegin, chpiclose,/ hpimage 

hpiutil ALLBASE/HP-UX HPIMAGE ... hpiutil(l) 

hpnls HP Native Language Support hpnls(5) 

HP-UX bootstrap and installation hpuxboot(lM) 

HP-UX files revck check revck(lM) 

hpux HP-UX bootstrap and hpuxboot(lM) 

HP-UX implementations magic(4) 

HP-UX machine identification model(4) 

HP-UX products sysrm(lM) 

HP-UX products update(lM) 

HP-UX revision information revisibn(l) 

HP-UX root volume rootmark(lM) 

HP-UX system reconfig(lM) 

HP-UX version uname(l) 

hsearch, hcreate, hdestroy manage hsearch(3C) 

hyperbolic functions i. sinh(3M) 
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hyphen find 

disk accounting data by user 

process group, and parent process 

semaphore set or shared memory 

names 

setpgrp2 set process group 

print effective current user 

issue issue 

model HP-UX machine 

lemgid language 

information what 

id print user and group 

real group, and effective group 

and saved user and group 

setuid, setgid set user and group 

on user's/ langinfo, langtoid, 

execution nohup 

query interactive 

core format of core 

quits nohup run a conmiand 

magic magic numbers for HP-UX 

processes ulimit 

which locate a program file 

findstr find strings for 

disk fsync synchronize a file's 

ptx permuted 

teletypes last, lastb 

errinfo error 

ermo error 

transfer speed io_speed ctl 

systems checklist static 

out the manual man find manual 

devices file of driver 

graphics/ CRT graphics 

Ipstat print LP status 

err report error 

/langtoid, idtolang, currlangid 

revision get HP-UX revision 

strip remove symbols and debug 

master master device 

linkinfo object file link 

what identify files for SCCS 

RETURN, ERROR, compile, step,/ 

inittab script for the 

initialization 

access list 

isl 

init, telinit process control 

/bcheckrc, re, powerfail system 

tset terminal dependent 

initgroups 

disk, or cartridge/ mediainit 

Format volume sdfinit 



hyphen find hyphenated words hyphen(l) 

hyphenated words hyphen(l) 

hypot Euclidean distance function hypot(3M) 

ID diskusg generate diskusg(lM) 

ID /getpgrp2 get process, getpid(2) 

id ipcrm remove a message queue, ipcrm(l) 

id print user and group IDs and id(l) 

ID setpgrp, setpgrp(2) 

id whoami whoami(l) 

identification file issue(4) 

identification model(4) 

identification variable langid(5) 

identify files for SCCS what(l) 

IDs and names id(l) 

IDs /real user, effective user, getuid(2) 

IDs /set real, effective, setresuid(2) 

IDs setuid(2) 

idtolang, currlangid information langinfo(3C) 

ignore hangups during command csh(l) 

IMAGE database access query(l) 

image file core(4) 

immune to hangups, logouts, and nohup(l) 

implementations magic(4) 

Luipuse file size limit foi child ^'^v^) 

including aliases and paths/ which(l) 

inclusion in message catalogs findstr(l) 

in-core state with its state on fsync(2) 

index ptx(l) 

indicate last logins of users and last(l) 

indicator errinfo(2) 

indicator for system calls ermo(2) 

inform system of required io_jspeed ctl(3I) 

information about the file checklist(4) 

information by keywords; print man(l) 

information for insf, mksf, Issf devices(4) 

information for CRT graphics(7) 

information Ipstat(l) 

information on last failure err(l) 

information on user's native/ langinfo(3C) 

information revision(l) 

information strip(l) 

information table master(4) 

information utility linkinfo(l) 

information what(l) 

INIT, GETC, PEEKC, UNGETC, regexp(5) 

init process inittab(4) 

init, telinit process control init(lM) 

initgroups initialize group initgroups(3C) 

initial system loader isl(lM) 

initialization init(lM) 

initialization shell scripts brc(lM) 

initialization tset(l) 

initialize group access list initgroups(3C) 

initialize hard disk, flexible mediainit (1) 

initialize Structured Directory sdfinit [SDF](1M) 
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process poi)en, pclose 

foreach 

process 

clri clear 



mode format of an 

inode format of an 

eval read argimients as shell 

eval read argmnents as shell 

scanf, fscanf , sscanf formatted 

source define source for command 

line read one line from user 

read, readv read 

read read line from standard 

ungetc push character back into 

stdio standard buffered 

fread, fwrite buffered binary 

clearerr, fileno stream status 

uustat uucp status 

/use findstr(l) output to 

to msert calls to getmsg(3C) 

file of driver information for 
install 

directories cpset 

insf 

hpux HP-UX bootstrap and 

abs return 

a641, 164a convert between long 

sputl, sgetl access long 

atol, atoi convert string to 

intrapon disable/enable 

/ltol3 convert between 3-byte 

between 3-byte integers and long 

area(s) osck check 

periodically sync for file system 

query 

system mailx 

file system consistency check and 

file system consistency check and 

file system consistency check and 

file system consistency check, 

isql ALLBASE/HP-UX 

HPIMAGE database access 

another user write 

lif logical 

bifbell 

mt magnetic tape 

terminal block mode library 

hpib Hewlett-Packard 

console system console 

compatibility stty termmal 

afi asynchronous FIFO 



initiate pipe I/O to/firom a popen(3S) 

initiate repetitive loop csh(l) 

inittab script for the init inittab(4) 

inode cb:i[non-SDF](lM) 

inode format of an inode inode[HFS](4) 

inode format of an i-node inode[SDF](4) 

inode inode[HFS](4) 

i-node inode(SDF](4) 

input and execute resulting/ csh(l) 

input and execute resulting/ sh(l) 

input conversion, read hrom/ scanf(3S) 

input csh(l) 

input line(l) 

input read(2) 

input sh(l) 

input stream ungetc(3S) 

input/output stream file package stdio(3S) 

input/output to a stream file fread(3S) 

inquiries ferror, feof, ferror(3S) 

inquiry and job control uustat(l) 

insert calls to getmsg(3C) insertmsg(l) 

insertmsg use findstr(l) output insertnisg(l) 

insf install special files insf(l) 

insf, mksf, Issf devices devices(4) 

install commands install(lM) 

install install commands install(lM) 

install object files in binary cpset(lM) 

install special files insf(l) 

installation utility hpuxboot(lM) 

integer absolute value abs(3C) 

integer and base-64 ASCII string a641(3C) 

integer data in a/ sputl(3X) 

integer strtol, strtol(3C) 

integer trap handler intrapoff, intrapoff(3m) 

integers and long integers 13tol(3C) 

integers 13tol, ltol3 convert 13tol(3C) 

integrity of OS in SDF boot osck(lM) 

integrity syncer syncer(lM) 

interactive IMAGE database access query (1) 

interactive message processing mailx(l) 

interactive repair biffsck Bell biffsck(lM) 

intersictive repair fsck fsck[HFS](lM) 

interactive repair fsck fsck[SDF](lM) 

interactive repair sdffsck SDF sdff8ck(lM) 

interactive SQL interface isqUl) 

interactive tool /ALLBASE/HP-UX iquery(l) 

interactively write (talk) to write(l) 

interchange format description lif (4) 

mterchange format utilities bif(4) 

interface and controls mt(7) 

interface blmode blmode(3C) 

Interface Bus driver hpib(7) 

Interface console(7) 

interface for Version 6/PWB sttyv6(7) 

interface gpio(7) 
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return status of HP-IB 

io_unlock lock and unlock an 

io_reset reset an I/O 

ALLBASE/HP-UX interactive SQL 

hpib_ppoll_resp_ctl Define 

termio genersil terminal 

HP-IB hpib rqst srvce allow 

diagO diagnostic 

tty controlling terminal 

swapon add a swap device for 

chatr change progreim's 

rehash recompute 

unhash disable use of 

HP7UX files revck check 

characters asa 

if a command type show 

basic Technical BASIC 

csh a shell (commsuid 

pipe create an 

facilities status ipcs report 

pfickage ftok standard 

io_on interrupt device 

blocked signals and wait for 

specify shell's treatment of 

io_interrupt_ctl enable/disable 

sleep suspend execution for an 

sleep suspend execution for 

setitimer get/set value of 

disable/enable integer trap/ 

trap handler intrapoff, 

ncheck generate names from 

in a file visible or/ vis, 

characters in a file visible or 

io reset reset an 

select synchronous 

establish a time limit for 

iostat report 

delog diagnostic event logger for 

diagO diagnostic interface to 

popen, pclose initiate pipe 

buffers hpib io perform 

commands 

termination character on special/ 

last read terminated 

interrupts for the associated/ 

vinlock an interface 

(fault) control 

required trtinsfer speed 

abort generate an 

limit for I/O operations 

interface io lock, 



interface hpib_bus status hpib_bus_status(3I) 

interface ioJock, io lock(3I) 

interface io reset(3I) 

interface isql isql(l) 

interface parallel poll response hpib_ppol] resp_ctl(3I) 

interface termio(7) 

interface to enable SRQ line on hpib__rqst srvce(3I) 

interface to I/O subsystem diag0(7) 

interface tty(7) 

interleaved paging/swapping swapon[HFS](2) 

internal attributes chatr(l) 

internal hash table csh(l) 

internal hash tables .■... csh(l) 

internal revision numbers of revck(lM) 

interpret ASA carriage control asa(l) 

interpretation of name as sh(l) 

interpreter basic(l) 

interpreter) with C-like syntax csh(l) 

interprocess chaimel pipe(2) 

inter-process communication ipcs(l) 

interprocess communication ..* stdipc(3C) 

interrupt (fault) control io on interrupt(3I) 

interrupt /atomically release sigpause(2) 

interrupts onintr csh(l) 

interrupts for the associated eid io interrupt_cti(3I) 

interval sleep(l) 

interval , sleep(3C) 

interval timer getitimer, getitimer(2) 

intrapoff, intrapon intrapoff(3m) 

intrapon disable/enable integer intrapoff(3m) 

i-numbers ncheck[non-SDF](lM) 

inv make unprintable characters vis(l) 

invisible /inv make unprintable vis(l) 

I/O interface io reset(3I) 

I/O multiplexing select(2) 

I/O operations io_timeout_ctl io_timeout_ctl(3I) 

I/O statistics iostat(l) 

I/O subsystem delog(lM) 

I/O subsystem diagO(7) 

I/O to/from a process popen(3S) 

I/O with an HP-IB channel from hpib_io(3I) 

ioctl control device ioctl(2) 

ioctl generic device control ioctl(5) 

io_eol ctl set up read io_eol_ctl(3I) 

io get term reason determine how io get term__reason(3I) 

io interrupt_ctl enable/disable io interrupt_ctl(3I) 

ioJock, io_unlock lock cind io lock(3I) 

iomap physical address mapping iomap(7) 

io_on interrupt device interrupt io_on interrupt(3I) 

io_reset reset an I/O interface io_reset(3I) 

io speed ctl inform system of io speed ctl(3I) 

iostat report I/O statistics iostat(l) 

lOT fault abort(3C) 

io timeout ctl establish a time io timeout ctl(3I) 

io—imlock lock and unlock an io lock(3I) 
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path 
Qory/ 

communication facilities status 

database access interactive tool 

/islower, isdigit, isxdigit, 

isdigit, isxdigit, isalnum,/ 

/isprint, isgraph, iscntrl, 

ttyname, 

/ispunct, isprint, isgraph, 

isalpha, isupper, islower, 

/isspace, ispunct, isprint, 

isalnum,/ isalpha, isupper, 

/isalnum, isspace, ispimct, 

/isxdigit, isalnum, isspace, 

SQL interface 

/isdigit, isxdigit, isalnmn, 

system 



isxdigit, isalnmn,/ isalpha, 

/isupper, islower, isdigit, 

news print news 

loop continue resume next 

functions 

functions jO, 

JO,jl, 

uustat uucp status inquiry and 

notify notify user of change in 

jobs list active 

send submit RJE 

/lrand48, nrand48, mrand48, 

transfer program 

program kermit 

makekey generate encryption 

man find manual informatioil by 

killall 

or a group of processes 

specified signal to a process 



mem, 

contents of directories Is, 

3-byte integers and long/ 

and base-64 ASCII string a641, 

default 

case 

vt login to another system over 

variable 

currlangid information on user's/ 

information on user's/ langinfo, 

/information on user's native 

astrn translate assembly 



io_width ctl set width of data , 

ipcrrn remove a message queue, , 

ipcs report inter-process 

iquery ALLBASE/HP-UX HPIMAGE 

isalnum, isspace, ispimct,/ 

isalpha, isupper, islower, , 

isascii classify characters 

isatty find ntmie of a terminal 

iscntrl, isascii classify/ 

isdigit, isxdigit, isalnum,/ 

isgraph, iscntrl, isascii/ 

isl initial system loader 

islower, isdigit, isxdigit, 

isprint, isgraph, iscntrl,/ 

ispunct, isprint, isgraph,/ 

isql ALLBASE/HP-UX interactive .... 

isspace, ispunct, isprint,/ 

issue a shell conunand 

issue identification file 

issue issue identification file 

isupper, islower, isdigit, 

isxdigit, isalnum, isspace,/ 

items 

iteration of enclosing for /next 

jO, jl, jn, yO, yl, yn Bessel 

jl, jn, yO, yl, yn Bessel 

jn, yO, yl, yn Bessel fimctions 

job control 

job status 

jobs 

jobs list active jobs 

jobs 

join relational database operator 

jrand48, srand48, seed48, lcong48/ .... 

kermit KERMIT-protocol file 

'KERMIT-protocol file transfer 

key 

keywords; print out the manual 

kill all active processes 

kill send a signal to a process 

kill send termination or 

kill terminate a process 

killall kill all active processes 

kmem main memory .■■ 

1, 11, Isf, Isr, Isx list 

13tol, ltol3 convert between 

164a convert between long integer 

label default in switch statement 

label in a switch statemeM 

Ian '. 



langid language identification 
langinfo, langtoid, idtolang, .. 
langtoid, idtolang, currlangid 
language as- given by NLS .... 
language ..; 



io_width_ctl(3I) 

ipcnn(l) 

ipcs(l) 

iquery (1) 

ctype(3C) 

ctype(3C) 

ctype(3C) 

ttyname(3C) 

ctype(3C) 

ctype(3C) 

ctype(3C) 

isl(lM) 

ctype(3C) 

ctype(3C) 

ctype(3C) 

isql(l) 

ctype(3C) 

system(3S) 

issue (4) 

issue(4) 

ctype(3C) 

ctype(3C) 

news(l) 

sh(l) 

bessel(3M) 

bessel(3M) 

bessel(3M) 

uustat (1) 

csh(l) 

csh(l) 

csh(l) 

send(l) 

join(l) 

drand48(3C) 

kermit(l) 

kermit (1) 

makekey (1) 

man(l) 

killall(lM) 

kill(2) 

csh(l) 

kill(l) 

killall(lM) 

mem(7) 

ls(l) 

13tol(3C) 

a641(3C) 

csh(l) 

csh(l) 

vt(l) 

langid(5) 

langinfo(3C) 

langinfo(3C) 

langinfo(3C) 

astrn(l) 
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atrans translate assembly 

pattern scanning and processing 

be arbitrary-precision arithmetic 

langid 

cpp the C 

command programming 

hpnls HP Native 

/collating sequence table for 

banner make posters in 

primes factor a nmnber, generate 

of users and teletypes 

users and teletypes last, 

cfiargefee, ckpacct, dodisk, 

at, batch execute commands at a 

/jrand48, srand48, seed48, 

into mantissa and/ frexp, 

leave remind you when you have to 

leave 

members one position to 

memvary modify segment 

truncate a file to a specified 

/optarg, optind, opterr get option 

uanner maKe posijcro in largc 

analysis of text 

lex generate programs for 

Isearch, 

symbol table format for object 

blmode terminal block mode 

ordering relation for an object 

archives ar archive and 

lifls list contents of a 

lifrm remove a 

lifcp copy to or from 

lifrename rename 

description 

lifinit write 

on file 
directory 



ulimit impose file size 

io_timeout_ctl establish a time 

ulimit get and set user 

wc word, 

establish an out-going terminal 

modem asynchronous serial modem 

continue execution on specified 

terminal type, modes, speed, and 

read read 

line read one 

getx25 get x25 

nl 

cut out selected fields of each 



language atrans(l) 

language awk text awk(l) 

language ^(1) 

language identification variable langid(5) 

language preprocessor cpp(l) 

language /the standard/restricted 8h(l) 

Language Support (NLS) Model hpnls(5) 

languages with 8-bit character/ col seq 8(4) 

large letters banner(l) 

large primes factor, f6«;tor(l) 

last, lastb indicate last logins last(l) 

lastb indicate last logins of last(l) 

lastlogin, monacct, nulladm,/ acctsh(lM) 

later time at(l) 

lcong48 generate imiformly/ drand48(3C) 

Id link editor ld(l) 

Idexp, modf split floating-point frexp(3C) 

leave leave(l) 

leave remind you when you have to leave(l) 

left shift shift argv csh(l) 

length memvary(2) 

length tnmcate, ftruncate truncate(2) 

letter from argument vector getopt(3C) 

letters banner'^1^ 

lex generate programs for lexical lex(l) 

lexical jinalysis of text lex(l) 

Ifind linear search and update lsearch(3C) 

libraries ranlib archive rsmlib(4) 

library interface blmode(3C) 

librsiry lorder find lorder(l) 

library maintainer for portable ^(1) 

LIF directory lifls(l) 

LIF file lifrm(l) 

LIF files lifcp(l) 

LIF files lifirename(l) 

lif logical interchange format iif(4) 

LIF volume header on file lifinit(l) 

lifcp copy to or from LIF files lifcp(l) 

lifinit write LIF volvmie header lifinit(l) 

lifls list contents of a LIF lifls(l) 

lifrename rename LIF files lifrename(l) 

lifrm remove a LIF file lifrm(l) 

limit for child processes sh(l) 

limit for I/O operations io_timeout_ctl(3I) 

limits ulimit(2) 

line, and charsicter coimt wc(l) 

line connection dial, undial dial(3C) 

line control modem(7) 

line goto csh(l) 

line discipline getty set getty(lM) 

line from standard input sh(l) 

line from user input line(l) 

line getx25(lM) 

line nmnbering filter nl(l) 

line of a file cut cut(l) 
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control the Remote Enable 
allow interface to enable SRQ 
send/cancel requests to an LP 

Ip 

input 

Isearch, Ifind 

col filter reverse 

ssp remove multiple 

comm select or reject 

device fold fold long 

head give first few 

uniq report repeated 

rev reverse 

gpio_get status return status 

of several files or subsequent 

subsequent/ paste merge same 

gpio__set_ctl set control 

link, imlink exercise 

Id 

a.out assembler and 

linkinfo object file 

cp, In, mv copy, 

SDF/ sdfcp, sdfln, sdfmv copy, 

link 

unlink system calls 

information utility 

Issf 

jobs 

lifls 

bifls 

Is, 1, 11, Isf, Isr, Isx 

sdfls, sdfll 

history Display event history 

Isdev 

getgroups get group access 

initialize group access 

nlist get entries from name 

setgroups set group access 

grouped by transaction uuls 

file nm print name 

varargs handle variable argument 

output of a varargs argument 

xargs construct argument 

of directories Is, 1, 

cp, 

mark SDF volimie boot area as 

isl initial system 

nl_asctime,/ ctime, nl ctime, 

aliases and paths (csh(l)/ which 

manual for program whereis 

hash remember command 

end, etext, edata last 

io lock, io unlock 



line on HP-IB hpib_ren_ctl hpib_ren_ctl(3I) 

line on HP-IB hpib rqst srvce hpib rqst srvce(3I) 

line printer Ip, cancel lp(l) 

line printer lp(7) 

line read one line from user line(l) 

linear search and update lsearch(3C) 

line-feeds and backspaces col(l) 

line-feeds from output ssp(l) 

lines common to two sorted files comm(l) 

lines for finite width output fold(l) 

lines head(l) 

lines in a file imiq(l) 

lines of a file rev(l) 

lines of GPIO card gpio_get_status(3I) 

lines of one file /same lines paste(l) 

lines of several files or paste(l) 

lines on GPIO card gpio_set_ctl(3I) 

link and imlink system calls link(lM) 

link editor ld(l) 

link editor output a.out(4) 

link information utility linkinfo(l) 

link link to a file link(2) 

link or move files cp(l) 

link, or move files to/from an sdfcp(l) 

link to a file link(2) 

link, unlink exercise link and link(lM) 

linkinfo object file link linkinfo(l) 

lint a C program checker /verifier lint(l) 

list a special file Issf(l) 

list active jobs csh(l) 

list contents of a LIF directory lifls(l) 

list contents of BIF directories bifls(l) 

list contents of directories ls(l) 

list contents of SDF directories sdfls(l) 

list csh(l) 

fist device drivers in the system Isdev(l) 

list getgroups(2) 

list initgroups initgroups(3C) 

list nlist(3C) 

list setgroups(2) 

list spooled uucp transactions uuls(lM) 

list (symbol table) of object nm(l) 

list varargs(5) 

list /vsprintf print formatted vprintf(3S) 

list(s) and execute command xargs(l) 

11, Isf, Isr, Isx list contents ls(l) 

In, mv copy, link or move files cp(l) 

loadable/non-loadable osmark osmark(lM) 

loader isl(lM) 

localtime, gmtime, asctime, ctime(3C) 

locate a program file including which(l) 

locate source, bin2iry, and/or whereis(l) 

location in search path sh(l) 

locations in program end(3C) 

lock and unlock an interface io_lock(3I) 
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allocating data and/ datalock 
memory plock 

record locking on files 

provide semaphores and record 

or segment memlck, memulck 

diagnostic events from the error 

diagnostic messages to form error 

gamma, signgam 

newgrp 

exponential, logarithm,/ exp, 

logarithm, power,/ exp, log, 

/loglO, pow, sqrt exponential, 

delog diagnostic event 

errfile system error 

description lif 

getlogin get 

logname get 

cuserid get character 

logname return 

passwd change 

chsh change default 

login terminate 

logout terminate 



set up user's environment at 

vt 

last, lastb indicate last 



run a command immune to hangups, 

setjmp, 

exit from enclosing for/next 

end terminate foreach or while 

foreach initiate repetitive 

exit from enclosing for/next 

iteration of enclosing for/next 

an object library 

nice run a command at 

positional parameters to next 

to an LP line printer 

cancel send/cancel requests to an 

enable, disable enable/disable 

/Ipshut, Ipmove start /stop the 

accept, reject allow/prevent 

mklp configure the 

Ipadmin configure the 

Ipstat print 

system 

scheduler find/ Ipsched, Ipshut, 

start/stop the LP request/ 

request scheduler and/ Ipsched, 



lock process into memory, after datalock(3C) 

lock process, text, or data in plock(2) 

lock reserve a terminal lock(l) 

lockf provide semaphores and lockf(2) 

locking on files lockf lockf(2) 

lock/imlock process address space memlck(2) 

log decode read Eind decode decode(lM) 

log dmesg collect system dmesg(lM) 

log gamma fimction gamma(3M) 

log in to a new group newgrp(l) 

log, loglO, pow, sqrt exp(3M) 

loglO, pow, sqrt exponential, exp(3M) 

logarithm, power, square root/ exp(3M) 

logger for I/O subsystem delog(lM) 

logging file errfile(4) 

logical interchange format lif(4) 

login name getlogin(3C) 

login name logn£ime(l) 

login name of the user cuserid(3S) 

login name of user logname(3X) 

login password passwd(l) 

login shell chsh(l) 

login shell csh(l) 

login shell csh(l) 

login sign on login(l) 

login terminate login shell csh(l) 

login time profile profile(4) 

login to another system over Ian vt(l) 

logins of users and teletypes last(l) 

logname get login name logname(l) 

logname return login name of user logname(3X) 

logout terminate login shell csh(l) 

logouts, and quits nohup nohup(l) 

longjmp non-local goto setjmp(3C) 

loop break csh(l) 

loop csh(l) 

loop csh(l) 

loop break sh(l) 

loop continue resiune next sh(l) 

lorder find ordering relation for lorder(l) 

low priority nice(l) 

lower position shift shift sh(l) 

Ip, cancel send/cancel requests lp(l) 

LP line printer Ip, lp(l) 

Ip line printer lp(7) 

LP printers enable(l) 

LP request scheduler and move/ Ipsched(lM) 

LP requests accept(lM) 

LP spooler subsystem mklp(lM) 

LP spooling system Ipadmin(lM) 

LP status information Ipstat(l) 

Ipadmin configure the LP spooling Ipadmin(lM) 

Ipmove start/stop the LP request Ipsched(lM) 

Ipsched, Ipshut, Ipmove Ipsched(lM) 

Ipshut, Ipmove start/stop the LP Ipsched(lM) 
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information 
jrand48,/ drajid48, erand48, 



ici^Luiit:& 



system 

update 

pointer; seek 

directories Is, 1, 11, 

directories Is, 1, 11, Isf, 

information for insf, mksf, 

Is, 1, 11, Isf, Isr, 
integers and long/ 13tol, 

model HP-UX 

values 

/access long integer data in a 

docmnents mm the MM 

m4 

this manual man 

documents formatted with the MM 

implementations 

implementations magic 

controls mt 

program mt 

from who is my 

prmail print out 

rmail send mail to users or read 

read mail 

mail, rmail send 

processing system 

malloc, free, realloc, calloc 

c£illoc, mallopt, mallinfo fast 

mem, kmem 

groups of programs make 

ar archive and library 

/free, realloc, calloc, mallopt, 

main memory allocator 

mallopt, mallinfo fast main/ 

malloc, free, realloc, calloc, 

pages for faster viewing with 

tsearch, tfind, tdelete, twalk 

hsearch, hcreate, hdestroy 

osmgr operating system 

records fwtmp, wtmpfix 

mt magnetic tape 

modf split floating-point into 

create the cat files for the 

locate source, binary, and/or 

print out the manual man find 

by keywords; print out the 

for formatting entries in this 

with man(l) fixman fix 

iomap physical address 

diffmk 



Ipstat print LP status Ipstat(l) 

lrand48, nrand48, mrand48, drand48(3C) 

Is, 1, 11, Isf, isr, Isx list is(l) 

Isdev list device drivers in the Isdev(l) 

Isearch, Ifind linear search and lse£irch(3C) 

Iseek move read/write file lseek(2) 

Isf, Isr, Isx list contents of ls(l) 

Isr, Isx list contents of ls(l) 

Issf devices file of driver devices(4) 

Issf list a special file Issf(l) 

Isx list contents of directories ls(l) 

ltol3 convert between 3-byte 13tol(3C) 

m4 macro processor m4(l) 

machine identification model(4) 

machine-dependent values values(5) 

machine-independent fashion sputl(3X) 

macro package for formatting mm(5) 

macro processor m4(l) 

macros for formatting entries in man(5) 

macros mm, osdd print/check mm(l) 

magic magic numbers for HP-UX magic(4) 

magic nmnbers for HP-UX magic(4) 

magnetic tape interface and mt(7) 

magnetic tape manipulating mt(l) 

mail from? from(l) 

mail in the post oflice prmail(l) 

mail mail, mail(l) 

mail, rmail send mail to users or mail(l) 

mail to users or read mail mail(l) 

mailx interactive message mailx(l) 

main memory allocator malloc(3C) 

main memory allocator /realloc, malloc(3X) 

main memory mem(7) 

maintain, update, and regenerate make(l) 

maintainer for portable archives ar(l) 

makekey generate encryption key makekey(l) 

mallinfo fast main memory/ malloc (3X) 

malloc, free, realloc, calloc malloc(3C) 

malloc, free, realloc, calloc, malloc(3X) 

mallopt, mallinfo fast main/ malloc(3X) 

man(l) fixman fix manual fixman(l) 

manage binary search trees tsearch(3C) 

manage hash search tables hsearch(3C) 

manager package description osmgr(lM) 

manipulate connect accounting fwtmp(lM) 

manipulating program mt(l) 

mantissa and exponent /Idexp, frexp(3C) 

manual catman catman(lM) 

manual for program whereis whereis(l) 

manual information by keywords; man(l) 

manual /find manual information man(l) 

manual man macros man(5) 

manual pages for faster viewing fixman(l) 

mapping iomap(7) 

mark differences between files diffmk(l) 
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readonly 

loadable/non-loadable osmark 

volume rootmark 

iimask set permissions 

mnask set permissions 

sigsetmask set current signal 

mnask set file-creation mode 

umask set and get file creation 

master 

table 

regular expression compile and 

math 

neqn format 

execution startup/ crtO.o, 

flexible disk, or cartridge tape 

upm unpack cpio archives from HP 

flexible disk, or cartridge tape/ 

reference patterns 

free address space 

shift shift argv 

groups show group 

memset memory operations 

access modes 

memory operations memccpy, 

operations memccpy, memchr, 

memccpy, memchr, memcmp, 

space memallc, 

process address space or segment 

stack/ datalock lock process into 

free, realloc, calloc main 

mallopt, mallinfo fast main 

shmctl shared 

spawn new process in a virtual 

queue, semaphore set or shared 

mem, kmem main 

memchr, memcmp, memcpy, memset 

shmop shared 

vstat collect virtual 

lock process, text, or data in 

memchmd change 

shmget get shared 

vmstat report virtual 

ems Extended 

alloc show dynamic 

memccpy, memchr, memcmp, memcpy, 

address space or segment memlck, 

sort sort and/or 

files acctmerg 

or subsequent lines of one/ paste 

terminal 

findmsg, dumpmsg create 



maik name as read-only sli(l) 

mark SDF volume boot area as osmark(lM) 

mark/unmark volmne as HP-UX root .... rootmark(lM) 

mask for creating new files csh(l) 

mask for creating new files sh(l) 

mask sigsetmask(2) 

mask umask(l) 

mask umask(2) 

master device information table master(4) 

master master device information master(4) 

match routines /step, advance regexp(5) 

math functions and constants math(5) 

math math fimctions and constants math(5) 

mathematical text for nrofF neqn(l) 

matherr error-handling function matherr(3M) 

mcrtO.o, frtO.o, mfrtO.o crt0(3) 

media /initialize hard disk, mediainit(l) 

media upm(l) 

mediainit initialize hard disk, mediainit(l) 

mem, kmem main memory mem(7) 

memadvise advise OS about segment memadvise(2) 

memallc, memfree allocate and memallc(2) 

members one position to left csh(l) 

memberships groups(l) 

memccpy, memchr, memcmp, memcpy, .. memory(3C) 

memchmd chfinge memory segment memchmd(2) 

memchr, memcmp, memcpy, memset memory(3C) 

memcmp, memcpy, memset memory memory(3C) 

memcpy, memset memory operations memory (3C) 

memfree allocate and free address memallc(2) 

memlck, memulck lock/unlock memlck(2) 

memory, after allocating data and datalock(3C) 

memory allocator malloc, malloc(3C) 

memory allocator /calloc, malloc(3X) 

memory control operations shmctl(2) 

memory efficient way vfork vfork(2) 

memory id ipcrm remove a message ipcrm(l) 

memory mem(7) 

memory operations memccpy, memory(3C) 

memory operations shmop(2) 

memory performance statistics vstat(lM) 

memory plock plock(2) 

memory segment access modes memchmd(2) 

memory segment shmget(2) 

memory statistics vmstat(l) 

Memory System ems(2) 

memory usage csh(l) 

memset memory operations memory(3C) 

memulck lock/unlock process memlck(2) 

memvary modify segment length memvary(2) 

merge files sort(l) 

merge or add total accounting acctmerg(lM) 

merge same lines of several files paste(l) 

mesg permit or deny messages to mesg(l) 

message catalog file for/ findnisg(l) 
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gencat generate a formatted 

catread MPE/RTE-style 

find strings for inclusion in 

msgctl 

getmsg get 

msgop 

mailx interactive 

msgget get 

shared memory id ipcrm remove a 

file mkstr extract error 

sys nerr system error 

dmesg collect system diagnostic 

mesg permit or deny 

crtO.o, mcrtO.o, frtO.o, 

/overview of accounting and 



subsystem 

files 
special or ordinary file 

of driver information for insf, 

C source into a file 

documents mm the 

documents formatted with the 

formatted with the MM macros 

formatting documents 

setmnt establish mount table 

chmod change 

hpib_eoi_ctl control EOI 

blmode terminal block 

umask set file-creation 

bifchmod change 

sdfchmod change 

chmod, fchmod change access 

HP Native Language Support (NLS) 

identification 

line control 

modem asynchronous serial 

change memory segment access 

getty set terminal type, 

bs a compiler/interpreter for 

mantissa and/ frexp, Idexp, 

of file touch update access, 

create message catalog file for 

utime set file access and 

memvary 

/ckpacct, dodisk, lastlogin. 



message catalog file gencat{l) 

message catalog support ,„,,,,., catread(3C) 

message catalogs findstr findstr(l) 

message control operations msgctl (2) 

message from a catalog getmsg(3C) 

message operations msgop(2) 

message processing system mailx(l) 

message queue msgget(2) 

message queue, semaphore set or ipcrm(l) 

messages from C source into a nikstr(l) 

messages /ermo, sys errlist, perror(3C) 

messages to form error log dmesg(lM) 

messages to terminal mesg(l) 

mfrtO.o execution startup/ crt0(3) 

miscellaneous accoimting commands acct(lM) 

mkdev make device files mkdev(lM) 

mkdir make a directory file mkdir(2) 

mkdir make a directory mkdir(l) 

mkfs construct a file system mkfs[HFS](lM) 

mklp configure the LP spooler mklp(lM) 

mknod create a special file entry mknod(4) 

mknod create special and fifo mknod(lM) 

mknod make a directory, or a mknod(2) 

mkrs construct a recovery system mkrs(lM) 

mksf, Issf devices file devices(4) 

mksf make a special file mksf(l) 

mkstr extract error messages from mkstr(l) 

mktemp make a imique file name mktemp(3C) 

MM macro package for formatting mm(5) 

MM macros mm, osdd print/check mm(l) 

mm, osdd print/check documents nun(l) 

mm the MM macro package for mm(5) 

mnttab mounted file system table mnttab(4) 

mnttab setmnt(lM) 

mode chmod(l) 

mode for HP-IB file hpib_eoi_ctl(3I) 

mode library interface blmode(3C) 

mode mask umask(l) 

mode of a BIF file bifchmod(l) 

mode of an SDF file sdfchmod(l) 

mode of file chmod(2) 

Model hpnls hpnls(5) 

model HP-UX machine model(4) 

modem asynchronous serial modem modem(7) 

modem line control modem(7) 

modes memchmd memchmd(2) 

modes, speed, and line discipline getty(lM) 

modest-sized programs bs(l) 

modf split floating-point into frexp (3C) 

modification, and/or change times touch(l) 

modification findmsg, dumpmsg findmsg(l) 

modification times utime(2) 

modify segment length memvary(2) 

monacct, nulladm, prctmp,/ acctsh(lM) 

monitor prepare execution profile monitor(3C) 
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uusub 

for crt viewing 

mount 

mount, umount 

mount, umount 

setmnt establish 

file system 

file system 

mnttab 

mvdir 

cp. In, mv copy, link or 

/sdfln, sdftnv copy, link, or 

seek Iseek 

the LP request scheduler and 

support catread 

/erand48, lrand48, nrand48, 



controls 

program 

ssp remove 

cp. In, 



devnm device 

tmpnam, tempnam create a 

ctermid generate file 

getpw get 

return value for environment 

getlogin get login 

nlist get entries from 

object file nm print 

logname get login 

mktemp make a unique file 

ttyname, isatty find 

gethostname get 

hostname set or print 

uname print 

uname get 

sethostname set 

tty get the 

cuserid get character login 

logname return login 

pwd working directory 

pwd working directory 

dirname extract portions of path 

term conventional 

ncheck generate 

id print user and group IDs and 

export export variable 

/currlangid information on user's 

Model hpnls HP 

i-numbers 



monitor uucp network uusub(lM) 

more, page file perusal filter more(l) 

moimt a file system moimt(2) 

mount and dismount file system mount[HFS](lM) 

mount and unmount file system moxmt[non-HFS](lM) 

moimt moimt a file system moimt(2) 

moimt table nmttab setmnt(lM) 

mount, umount mount and dismount moimt[HFS](lM) 

mount, imioimt mount and unmoimt moimt[non-HFS](lM) 

mounted file system table nmttab(4) 

move a directory mvdir(lM) 

move files cp(l) 

move files to/from an SDF volume sdfcp(l) 

move read/write file pointer; lseek(2) 

move requests /Ipmove start/stop Ipsched(lM) 

MPE/RTE-style message catalog catread(3C) 

mrand48, jrand48, srand48,/ drand48(3C) 

msgctl message control operations nisgctl(2) 

msgget get message queue msgget(2) 

msgop message operations msgop(2) 

mt magnetic tape interface sad mt(7) 

mt magnetic tape manipulating mt(l) 

multiple line-feeds from output ssp(l) 

multiplexing select'^2^ 

mv copy, link or move files cp(l) 

mvdir move a directory mvdir(lM) 

name devmn(lM) 

name for a temporfiry file tmpnam(3S) 

name for terminal ctermid(3S) 

name from UID getpw(3C) 

name getenv getenv(3C) 

name getlogin(3C) 

name list nlist(3C) 

name list (symbol table) of nm(l) 

name logname(l) 

name mktemp(3C) 

name of a terminal ttyname(3C) 

name of current host gethostname(2) 

name of current host system hostname(l) 

name of current HP-UX version uname(l) 

name of currentHP-UX system uname(2) 

name of host cpu sethostname(2) 

name of the terminal tty(l) 

name of the user cuserid(3S) 

name of user logname(3X) 

name pwd(l) 

name ^^(1) 

names basename, basename(l) 

names for terminals term(5) 

names from i-numbers ncheck[non-SDF](lM) 

names id(l) 

names to enviromnent of/ sh(l) 

native language as given by NLS langinfo(3C) 

Native Language Support (NLS) hpnls(5) 

ncheck generate names from ncheck[non-SDF](lM) 
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continue resume execution of 

nroflF 

uusub monitor uucp 

file 

newgrp 
newgrp 

newgrp equivalent to exec 

newgrp equivalent to exec 

rmnl remove extra 

news print 

for/next loop continue resimie 
shift positional parameters to 



priority 

/localtime, gmtime, asctime, 

strtod, atof, nl strtod, 

asctime, nl asctime,/ ctime, 

number to/ ecvt, fcvt, gcvt, 

/nl isupper, nl islower, 

nl_islower, nl_isalnum,/ 

for use/ /nl ispunct, nl isprint, 

nl isalpha, nl isupper, 

/nl isalnum, nl ispunct, 

/nl islower, nl isalnum. 



nlist 
nlist 

nl isalnum,/ nl isalpha, 

native language as given by 

hpnls HP Native Language Support 

translate characters for use with 

classify characters for use with 

to/ strtod, atof, 

for use with NLS nLtoupper, 

16-bit characters 

characters for use with NLS 

of object file 

command execution 

hangups, logouts, and quits 

/strncmpS, strcmpl6, strncmpl6 

setjmp, longjmp 

commands while expression is 

job status 

status notify 

drand48, erand48, lrand48, 

neqn format mathematical text for 
tbl format tables for 



nearest while or foreach csh(l) 

neqn format mathematical text for neqn(l) 

network uusub(lM) 

newform change or reformat a text newfonn(l) 

newfs construct a new file system newfs[HFS](lM) 

newgrp equivalent to exec csh(l) 

newgrp equivalent to exec sh(l) 

newgrp log in to a new group newgrp(l) 

newgrp csh(l) 

newgrp sh(l) 

new-line characters from file rnml(l) 

news items news(l) 

news print news items news(l) 

next iteration of enclosing sh(l) 

next lower position shift sh(l) 

nice alter command priority csh(l) 

nice change priority of a process nice(2) 

nice run a command at low nice(l) 

nl line numbering filter nKl) 

nLasctime, timezone, daylight,/ ctime(3C) 

nl atof convert string to/ strtod(3C) 

nLctime, localtime, gmtime, ctime(3C) 

nLgcvt convert floating-point ecvt(3C) 

nl isalnum, nl ispunct,/ nl ctype(3C) 

nl isalpha, nl isupper, nl ctype(3C) 

nl isgraph classify characters nl ctype(3C) 

nl islower, nl isalnum,/ nl ctype(3C) 

nl isprint, nl isgraph classify/ nl ctype(3C) 

nl_ispunct, nl_isprint,/ nl ctype(3C) 

nlist get entries from name list nlist(3C) 

nlist nlist structure format nlist (4) 

nlist nlist structure format nlist (4) 

nlist structure format nlist(4) 

nlist structure format nlist(4) 

nl isupper, nl islower, nl ctype(3C) 

NLS /information on user's langinfo(3C) 

(NLS) Model hpnls(5) 

NLS nLtoupper, nLtolower nl conv(3C) 

NLS /nl_isprint, nl_isgraph nl ctype(3C) 

nl strtod, nl_atof convert string strtod(3C) 

nLtolower translate characters nl conv(3C) 

nLtools_16 tools to process nl tools_16(3C) 

nLtoupper, nLtolower translate nl conv(3C) 

nm print name list (symbol table) nm(l) 

nohup ignore hangups during csh(l) 

nohup run a command immune to nohup(l) 

non-ASCII string collation nl string(3C) 

non-local goto setjmp(3C) 

non-zero while execute csh(l) 

notify notify user of change in csh(l) 

notify user of change in job csh(l) 

nrand48, mrand48, jrand48,/ drand48(3C) 

nroff format text nroff(l) 

nroff neqn(l) 

nroff tbl(l) 
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constructs deroff remove 
null 

/dodisk, lastlogin, monacct, 

convert string to floating point 

factor, primes factor a 

bifdf report 

df report 

sdfdf report 

string to double-precision 

nl—gcvt convert floating-point 

print formatted output with 

nl line 

distributed pseudo-random 

magic magic 

revck check internal revision 

trapno hardware trap 

utility linkinfo 

print name list (symbol table) of 

directories cpset install 

size print section sizes of 

archive symbol table format for 

find ordering relation for an 

'find the ^rintable strings in a 

a particular parallel poll value 

od, xd 

prmail print out mail in the post 

repeat execute command more than 

of interrupts 

aliases and paths (csh(l) 

dup duplicate an 

specific slot dup2 duplicate an 

open 

writing 

convert/ fopen, freopen, fdopen 

seekdir, rewinddir, closedir/ 

description osmgr 

chsys change to difi"erent 

copy, create, append to, split 

savecore save a core diunp of the 

reboot stopsys stop 

rewinddir, closedir directory 

establish a time limit for I/O 

memcmp, memcpy, memset memory 

msgctl message control 

msgop uiessage 

semctl semaphore control 

semop semaphore 

shmctl shared memory control 

shmop shared memory 

strcspn, strtok character string 

join relational database 

letter from argument/ getopt, 

argument/ getopt, optarg, optind, 



nroff/troff, tbl, and eqn deroff'(l) 

nuU file null(7) 

null null file null(7) 

nulladm, prctmp, prdaily,/ acctsh(lM) 

number cvtnum cvtnum(3C) 

number, generate large primes factor(l) 

number of free disk blocks bifdf(lM) 

number of free disk blocks df(lM) 

number of free SDF disk blocks sdfdf(lM) 

number /nl atof convert strtod(3C) 

number to string /fcvt, gcvt, ecvt(3C) 

numbered arguments /sprintmsg printmsg(3C) 

numbering filter iil(l) 

numbers /generate uniformly drand48(3C) 

numbers for HP-UX implementations .... magic(4) 

numbers of HP-UX files revck(lM) 

numbers trapno(2) 

object file link information linkinfo(l) 

object file nm nm(l) 

object files in binary cpset(lM) 

object files size(l) 

object libraries ranlib ranlib(4) 

object library lorder lorder(l) 

rjVjiorf Qr other bluar^ file .----------^ii;;:;: strint's^l'^ 

occurs /wait until hpib_wait_on ppoll(3I) 

octal and hexadecimal dump od(l) 

od, xd octal and hexadecimal diunp od(l) 

office prmail(l) 

once csh(l) 

onintr specify shell's treatment csh(l) 

only) /a program file including which(l) 

open file descriptor dup(2) 

open file descriptor to a dup2(2) 

open file for reading or writing open(2) 

open open file for reading or open(2) 

open or re-open a stream file; fopen(3S) 

opendir, readdir, telldir, directory(3C) 

operating system manager package osmgr(lM) 

operating system or version chsys(lM) 

operating system oscp oscp(lM) 

operating system savecore(lM) 

operating system with optional stopsys(lM) 

operations /telldir, seekdir, directory(3C) 

operations io_timeout_ctl io_timeout_ctl(3I) 

operations memccpy, memchr, memory(3C) 

operations msgctl(2) 

operations msgop(2) 

operations semctl(2) 

operations semop(2) 

operations shmctl(2) 

operations shmop(2) 

operations /strpbrk, strspn, string(3C) 

operator join(l) 

optarg, optind, opterr get option getopt(3C) 

opterr get option letter from getopt(3C) 
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curses CRT screen handling and 

from argument/ getopt, optarg, 

/optarg, optind, opterr get 

sysrm remove 

update update 

stop operating system with 

fcntl file control 

sip set the 

stty set the 

getopt parse command 

library lorder find 

make a directory, or a special or 

vson, vsoff advise 

patterns memadvise advise 

osck check integrity of 

boot area(s) 

split operating system 

formatted with the MM macros mm, 

as loadable/non-loadable 

package description 

dial, undial establish an 

a. out assembler and link editor 

fold long lines for finite width 

/vsprintf print formatted 

fprintf, sprintf print formatted 

remove multiple line-feeds from 

insertmsg use findstr(l) 

/sprintmsg print formatted 

/acctdusg, accton, acctwtmp 

chown, fchown change 

bifchown, bifchgrp change file 

chown, chgrp change file 

sdfchown, sdfchgrp change 

expand files 

screen handling and optimization 

osmgr operating system manager 

mm the MM macro 

buffered input/output stream file 

interprocess communication 

viewing more, 

man(l) fixman fix manual 

enable additional device for 

add a swap device for interleaved 

hpib_ppoll conduct 

/control response to 

/Define interface 

/wait until a particular 

shift shift positional 

get process, process group, and 

getopt 

tail deliver the last 

hpib_wait_on ppoU wait until a 

pc 
cdb, fdb, pdb C, FORTRAN, 



optimization package curses(3X) 

optind, opterr get option letter getopt(3C) 

option letter from argument/ getopt (3C) 

optional HP-UX products sysnn(lM) 

optional HP-UX products update(lM) 

optional reboot stopsys stopsys(lM) 

options fcntl(5) 

options for a printer slp(l) 

options for a terminal port stty(l) 

options getopt(l) 

opx25 execute HALGOL programs opx25(lM) 

ordering relation for an object lorder(l) 

ordinary file mknod niknod(2) 

OS about backing store devices vson(2) 

OS about segment reference memadvise(2) 

OS in SDF boot area(s) osck(lM) 

osck check integrity of OS in SDF osck(lM) 

oscp copy, create, append to, oscp(lM) 

osdd print/check docmnents mm(l) 

osmark mark SDF volume boot area osmark(lM) 

osmgr operating system manager osmgr(lM) 

out-going terminal line/ dial(3C) 

output a.out(4) 

output device fold fold(l) 

output of a varargs argmnent list vprintf(3S) 

output printf, printf(3S) 

output ssp ssp(l) 

output to insert calls to/ insertmsg(l) 

output with numbered arguments printmsg(3C) 

overview of accounting and/ acct(lM) 

owner and group of a file chown(2) 

owner or group bifchown(l) 

owner or group chown(l) 

owner or group of an SDF file sdfchown(l) 

pack, peat, unpack compress and pack(l) 

package curses CRT curses(3X) 

package description osmgr(lM) 

package for formatting documents mm(5) 

package stdio standard stdio(3S) 

package ftok standard stdipc(3C) 

page file perusal filter for crt more(l) 

pages for faster viewing with fixman(l) 

paging and swapping swapon swapon[HFS](lM) 

paging/swapping swapon swapon [HFS] (2) 

parallel poll on HP-IB bus hpib_ppoll(3I) 

parallel poll on HP-IB hpib_card ppoll_resp(3I) 

parallel poll response hpib_ppoll resp_ctl(3I) 

parallel poll value occurs hpib_wait_on ppoll(3I) 

parameters to next lower position sh(l) 

parent process ID /getpgrp2 getpid(2) 

parse command options getopt(l) 

part of a file tail(l) 

particular parallel poll value/ hpib_wait_on ppoll(3I) 

Pascal compiler pc(l) 

Pascal symbolic debugger cdb(l) 
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setpwent, endpwent, fgetpwent get 

putpwent write 

passwd 

gr^nass read a 

passwd change login 

pwck, grpck 

files or subsequent lines of one/ 

io_width ctl set width of data 

dimame extract portions of 

command location in search 

router 

directory getcwd get 

file including aliases and 

egrep, fgrep search a file for a 

language awk text 

advise OS about segment reference 

signal 

files pack, 

a process popen, 

debugger cdb, fdb, 

truth/ /hp9000s500, hp9000s800, 

compile, step,/ INIT, GETC, 

from buffers hpib^o 

vstat collect virtual memory 

integrity syncer 

files umask set 

files umask set 

terminal mesg 

ptx 

format acct 

acctcms command summary from 

sys nerr system error messages 

more, page file 

terminals pg file 

soft-copy terminals 

iomap 

split split a file into 

channel 

tee 

popen, pclose initiate 

in memory 

cvtnum convert string to fioating 

rewind, ftell reposition a file 

Iseek move read/write file 

hpib ^ppoU conduct parallel 

hpib spoil conduct a serial 

/control response to parallel 

/Define interface parallel 

/wait imtil a particular parallel 

popd 

to/from a process 



passwd change login password passwd(l) 

passwd password file, pwd.h passwd(4) 

password file entry /getpwnam, getpwent(3C) 

password file entry putpwent(3C) 

password file, pwd.h passwd(4) 

password getpass(3C) 

password passwd(l) 

password/group file checkers pwck(lM) 

paste merge same lines of several paste(l) 

path io_width_ctl(3I) 

path names basename, basename(l) 

path hash remember sh(l) 

pathahas electronic address pathalias(l) 

path-name of current working getcwd(3C) 

paths (csh(l) only) /a program which{l) 

pattern grep, grep(l) 

pattern scaiming and processing awk(l) 

patterns memadvise memadvise(2) 

pause suspend process imtil pause(2) 

pc Pascal compiler pc(l) 

peat, unpack compress and expand pack(l) 

pclose initiate pipe I/O to/from pop€n(3S) 

pdb C, FORTRAN, Pascal symbolic cdb(l) 

pdpll, u3b, u3b5, vax provide machid(l) 

PEEKC, UNGETC, RETURN, ERROR, regexp(5) 

perform I/O with an HP-IB channel hpib_io(3I) 

performance statistics vstat(lM) 

periodically sync for file system syncer(lM) 

permissions mask for creating new csh(l) 

permissions mask for creating new sh(l) 

permit or deny messages to mesg(l) 

permuted index ptx(l) 

per-process accoimting file acct(4) 

per-process accounting records acctcms(lM) 

perror, errno, sys_errlist, perror(3C) 

perusal filter for crt viewing more(l) 

perusal filter for soft-copy Pg(l) 

pg file perusal filter for Pg(l) 

physical address mapping iomap(7) 

pieces split(l) 

pipe create an interprocess pipe(2) 

pipe fitting tee(l) 

pipe I/O to/from a process popen(3S) 

plock lock process, text, or data plock(2) 

point munber cvtmun(3C) 

pointer in a stream fseek, fseek(3S) 

pointer; seek lseek(2) 

poll on HP-IB bus hpib_ppoll(3I) 

poll on HP-IB bus hpib^poll(3I) 

poll on HP-IB hpib_card ppoll_resp(3I 

poll response hpib_ppol] resp_ctl(3I) 

poll value occurs hpib__wait_on ppoll(3I) 

pop directory stack csh(l) 

popd pop directory stack csh(l) 

popen, pclose initiate pipe I/O popen(3S) 
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set the options for a terminEil 

taaua uaoc \ji ucixxiixicu tjrpca uy 

and library maintainer for 

basensime, dimsime extract 

parameters to next lower 

shift argv members one 

lower position shift shift 

prmail print out mail in the 

banner make 

power, square/ exp, log, loglO, 

/pow, sqrt exponential, logarithm, 

shell scripts brc, bcheckrc, re, 

/lastlogin, monacct, nulladm, 
/monacct, nulladm, prctmp, 

storage 

prealloc 

prealloc 

ftime get date and time more 

monitor 

cpp the C language 

unget undo a 

large primes factor, 

factor a number, generate large 

types 

children process times time 

process times times 

date 

prs 

echo echo 

echo echo 

echo echo 

cal 

a file svmi 

activity sact 

whoami 

cat concatenate, copy, cind 

pr 

vprintf, vfprintf, vsprintf 

printf, fprintf, sprintf 

printmsg, fprintmsg, sprintmsg 

statistics hashstat 

Ipstat 

object file nm 

hostname set or 

version uname 

news 

prmail 

manual information by keywords; 

acctcom search and 

files size 

dirs 

names id 

other binary,/ strings find the 



port stty stty(l) 

port ttytype ttytype(4) 

portable archives ar archive ar(l) 

portions of path names basename(l) 

position shift shift positional sh(l) 

position to left shift csh(l) 

positional parameters to next sh(l) 

post ofl^ce prmail(l) 

posters in large letters banner(l) 

pow, sqrt exponential, logarithm, exp(3M) 

power, square root fimctions exp(3M) 

powerfail system initialization brc(lM) 

pr print files pr(l) 

prctmp, prdaily, prtacct,/ acctsh(lM) 

prdaily, prtacct, nmacct,/ acctsh(lM) 

prealloc preallocate disk storage prealloc(l) 

prealloc preallocate fast disk prealloc(2) 

preallocate disk storage prealloc(l) 

preallocate fast disk storage prealloc(2) 

precisely ftime(2) 

prepare execution profile monitor(3C) 

preprocessor cpp(l) 

previous get of an SCCS file unget(l) 

primes factor a number, generate f£ictor(l) 

primes factor, primes factor(l) 

primitive system data types types(5) 

print accumulated shell and sh(l) 

print accumulated user and system sh(l) 

print and set the date date(l) 

print and summarize an SCCS file prs(l) 

(print) arguments csh(l) 

(print) arguments echo(l) 

(print) arguments sh(l) 

print calendar cal(l) 

print checksmn and block count of sum(l) 

print current SCCS file editing sact(l) 

print effective current user id whoami(l) 

print files cat(l) 

print files Pi'(l) 

print formatted output of a/ vprintf(3S) 

print formatted output printf(3S) 

print formatted output with/ printmsg(3C) 

print hash table effectiveness csh(l) 

print LP status information Ipstat (1) 

print name list (symbol table) of nm(l) 

print name of current host system hostname(l) 

print name of current HP-UX uname(l) 

print news items news(l) 

print out mail in the post office prmail(l) 

print out the manual man find man(l) 

print process accoimting file(s) acctcom(l) 

print section sizes of object size(l) 

print the directory stack csh(l) 

print user and group IDs and id(l) 

printable strings in a object, or strings(l) 
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with the MM macros mm, osdd 

requests to an LP line 

Ip line 

sip set the options for a 

enable, disable enable/disable LP 

formatted output 

print formatted output with/ 

nice alter command 

nice run a command at low 

nice change 

execute process with realtime 

rtprio change or read realtime 

values 

privgrp format of 

office 

/shutacct, startup, turnacct shell 

nl tools_16 tools to 

acct enable or disable 

acctprcl, acctprc2 

acctcom search and print 

memlck, memulck lock/unlock 

times get 

status wait wait for 

boot bootstrap 

init, telinit 

command without creating new 

or specified signal to a 

exit, _exit terminate 

fork create a new 

/getppid, getpgrp2 get process, 

setpgrp, setpgrp2 set 

process group, and parent 

efficient way vfork spawn new 

inittab script for the init 

allocating data/ datalock lock 

kill terminate a 

nice change priority of a 

kill send a signal to a 

initiate pipe I/O to/from a 

/getpgrp, getppid, getpgrp2 get 

command without creating new 

ps report 

plock lock 

accimiulated shell and children 

print accumulated user and system 

times get process and child 

wait wait for child 

ptrEice 

pause suspend 

wait await completion of 

rtprio execute 

wait wait for background 

signal to a process or a group of 

killall kill all active 

impose file size limit for child 



print/check docimients formatted mm(l) 

printer Ip, cancel send/cancel lp(l) 

printer lp(7) 

printer slp(l) 

printers enable(l) 

printf, fprintf, sprintf print printf(3S) 

printmsg, fprintmsg, sprintmsg printmsg(3C) 

priority csh(l) 

priority nice(l) 

priority of a process nice(2) 

priority rtprio rtprio(l) 

priority rtprio(2) 

privgrp format of privileged privgrp(4) 

privileged values privgrp(4) 

prmail print out mail in the post prmail(l) 

procedures for accounting acctsh(lM) 

process 16-bit characters nl tools_16(3C) 

process accounting acct(2) 

process accounting acctprc(lM) 

process accounting file(s) acctcom(l) 

process address space or segment memlck(2) 

process and child process times times(2) 

process and report termination sh(l) 

process boot(lM) 

process control initialization init(lM) 

process exec execute csh(l) 

process kill send termination csh(l) 

process exit(2) 

process fork(2) 

process group, and parent process/ getpid(2) 

process group ID setpgrp(2) 

process ID /getpgrp2 get process, getpid(2) 

process in a virtual memory vfork(2) 

process inittab(4) 

process into memory, after datalock(3C) 

process kill(l) 

process nice(2) 

process or a group of processes kill(2) 

process popen, pclose popen(3S) 

process, process group, and/ getpid(2) 

process exec execute sh(l) 

process status ps(l) 

process, text, or data in memory plock(2) 

process times time print sh(l) 

process times times sh(l) 

process times times(2) 

process to stop or terminate wait(2) 

process trace ptrace(2) 

process until signal pause(2) 

process wait(l) 

process with realtime priority rtprio(l) 

processes csh(l) 

processes kill send a kill(2) 

processes killall(lM) 

processes ulimit sh(l) 
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awk text pattern scanning and 

shutdown terminate all 

mailx interactive message 

m4 macro 

provide truth value about your 

alarm set a 

sysrm remove optional HP-UX 

update update optional HP-UX 



prof display 

monitor prepare execution 

profil execution time 

at login time 

prof 

assert verify 

cbC 

lint a C 

cxref generate C 

etext, edata last locations in 

and paths (csh(l)/ which locate a 

KERMIT-protocol file transfer 

mt magnetic tape manipulating 

sdiff side-by-side difference 

XMODEM-protocol file transfer 

units conversion 

source, binary, and/or manual for 

the standard/restricted command 

for modest-sized 

text lex generate 

chatr change 

update, and regenerate groups of 

opx25 execute HALGOL 

locking on files lockf 

/hp9000s800, pdpll, u3b, u3b5, vax 

true, false 

file 

/nulladm, prctmp, prdaily, 

pty 
generate uniformly distributed 



file copy uuto, uupick 

emulation aterm general 

stream ungetc 

pushd 

puts, ^uts 

putc, putchar, fputc, putw 

character or word on a stream 

character or word on a/ putc, 

environment 



processing Ifinguage awk(l) 

processing shutdown(lM) 

processing system mailx(l) 

processor m4(l) 

processor type /u3b, u3b5, vax machid(l) 

process's alarm clock alarm(2) 

products sysrm(lM) 

products update(lM) 

prof display profile data prof(l) 

prof profile within a fimction prof(5) 

profil execution time profile profil(2) 

profile data prof(l) 

profile monitor(3C) 

profile profil(2) 

profile set up user's environment profile(4) 

profile within a function prof(5) 

program assertion assert(3X) 

program beautifier, formatter cb(l) 

program checker/verifier lint(l) 

program cross-reference cxref(l) 

program end, end(3C) 

program file including ahases which(l) 

program kermit kermit(l) 

program mt(l) 

program sdiflF(l) 

program umodem umodem(l) 

program units(l) 

program whereis locate whereis(l) 

programming language /rsh shell, sh(l) 

programs /a compiler/interpreter hs(l) 

programs for lexical analysis of lex(l) 

program's internal attributes chatr(l) 

programs make maintain, make(l) 

programs opx25(lM) 

provide semaphores and record lockf(2) 

provide truth value about your/ machid(l) 

provide truth veilues true(l) 

prs print £ind summsirize an SCCS prs(l) 

prtacct, nmacct, shutacct,/ acctsh(lM) 

ps report process status ps(l) 

pseudo terminal driver pty(7) 

pseudo-random numbers /lcong48 drand48(3C) 

ptrace process trace ptrace(2) 

ptx permuted index ptx(l) 

pty pseudo terminal driver pty(7) 

public UNIX system to UNIX system .... uuto(l) 

purpose asynchronous terminal aterm(l) 

push character back into input ungetc(3S) 

push directory stack csh(l) 

pushd push directory stack csh(l) 

put a string on a stream puts(3S) 

put character or word on a stream putc(3S) 

putc, putchar, fputc, putw put putc(3S) 

putchar, fputc, putw put putc(3S) 

putenv change or add value to putenv(3C) 
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entry 

stream 

getutent, getutid, getutline, 

stream putc, putchar, fputc, 

checkers 



passwd password file, 

access 

tput 

msgget get message 

memory id ipcrm remove a message 

qsort 

immune to hangups, logouts, and 

generator 

rand, srand simple 

format for object libraries 

ratfor 
initialization/ brc, bcheckrc. 



from the error log decode 

execute resulting commands eval 

execute resulting commands eval 

formatted input conversion, 

read, readv 

read 

mail, rmail send mail to users or 

line 

input 

rtprio change or 
/determine how last 

special file io_eo] ctl set up 

rewinddir, closedir/ opendir, 

open open file for 

read-only 

readonly mark name as 

read, 

Iseek move 

and/ setresuid, setresgid set 

/get real user, effective user, 

/geteuid, getgid, getegid get 

allocator malloc, free, 

mallinfo fast main/ malloc, free, 

rtprio execute process with 

rtprio change or read 

(tape) file dd convert. 



operating system with optional 

reboot 

signal specify what to do upon 

trap execute command upon 



putpwent write password file putpwent(3C) 

puts, fputs put a string on a puts(3S) 

pututline, setutent, endutent,/ getut(3C) 

putw put character or word on a putc(3S) 

pwck, grpck password/group file pwck(lM) 

pwd working directory naxae pwd(l) 

pwd working directory name sh(l) 

pwd.h passwd(4) 

qsort quicker sort qsort(3C) 

query interactive IMAGE database query(l) 

query terminfo database tput(l) 

queue msgget(2) 

queue, semaphore set or shared ipcrm(l) 

quicker sort qsort(3C) 

quits nohup run a command nohup(l) 

r£ind, srand simple random-number rand(3C) 

random-number generator rand(3C) 

ranlib archive symbol table ranlib(4) 

ratfor rational Fortran dialect ratfor(l) 

rational Fortran dialect ratfor(l) 

re, powerfail system brc(lM) 

read a password getpass(3C) 

read and decode diagnostic events decode(lM) 

read argimients as shell input and csh(l) 

read argmnents as shell input and sh(l) 

read from stream file /sscanf scanf(3S) 

read input read(2) 

read line from standard input sh(l) 

read mail mail(l) 

read one line from user input line(l) 

read read line from standard sh(l) 

read, readv read input read(2) 

read realtime priority rtprio(2) 

read terminated io_get__term__reason(3I) 

read termination character on io eol ctl(3I) 

readdir, telldir. seekdir directory(3C) 

reading or writing open(2) 

readonly mark name as sh(l) 

read-only sh(l) 

readv read input read(2) 

read/write file pointer; seek lseek(2) 

real, effective, and saved user setresuid(2) 

real group, and effective group/ getuid(2) 

real user, effective user, real/ getuid(2) 

realloc, calloc main memory malloc(3C) 

realloc, calloc, mallopt, malloc(3X) 

realtime priority rtprio(l) 

realtime priority rtprio(2) 

reblock, translate, smd copy a dd(l) 

reboot boot the system reboot(2) 

reboot reboot the system reboot(lM) 

reboot stopsys stop stopsys{lM) 

reboot the system reboot(lM) 

receipt of a signal signal(2) 

receipt of signal sh(l) 
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rehash 

system 

uconiig system 

lockf provide semaphores and 

from per-process accoimting 

manipulate connect accoimting 

mkrs construct a 

ed, 

memadvise advise OS about segment 

newform change or 

regular expression 

meike maintain, update, and 

expression regcmp, 

/ERROR, compile, step, advance 

regcmp, regex compile and execute 

table 

accept, 

files comm select or 

lorder find ordering 

join 

for/ sigpause atomically 

ceil, fmod, fabs floor, ceiling, 

search path hash 

leave 

calendar 

hpib ren ctl control the 

ct spawn getty to a 

rmdel 

rmdir 

lifrm 

set or shared memory id ipcrm 

bifrm, bifrmdir 

flags and arguments imset 

flags and argimients unset 

file unlink 

from file rmnl 

rm, rmdir 

output ssp 

constructs deroff 

sysrm 

sdfrm, sdfrmdir 

information strip 

unsetenv 

lifrename 

fopen, freopen, fdopen open or 

consistency check and interactive 

consistency check and interactive 

consistency check and interactive 

consistency check, interactive 

once 

uniq report 

foreach initiate 

clock 

failure err 

communication facilities/ ipcs 



recompute internal hash table csh(l) 

reconfig configure an HP-UX reconfig{lM) 

reconfiguration uconfig(lM) 

record locking on files lockf(2) 

records acctcms command simmiary acctcms(lM) 

records fwtmp, wtmpfix fwtmp(lM) 

recovery system mkrs(lM) 

red text editor ed(l) 

reference patterns memadvise(2) 

reformat a text file newform(l) 

regcmp, regex compile and execute regcmp(3X) 

regenerate groups of programs make(l) 

regex compile and execute regular regcmp(3X) 

regular expression compile and/ regexp(5) 

regular expression regcmp(3X) 

rehash recompute internal hash csh(l) 

reject allow/prevent LP requests accept(lM) 

reject lines common to two sorted comm(l) 

relation for an object library lorder(l) 

relational database operator join(l) 

release blocked signals and wait sigpause(2) 

remainder, absolute value/ floor, floor(3M) 

remember command location in sh(l) 

remind you when you have to leave leave(l) 

reminder service calendar(l) 

Remote Enable line on HP-IB hpib_ren ctl(3I) 

remote terminal (call terminal) ct(l) 

remove a delta from an SCCS file rmdel(l) 

remove a directory file rmdir(2) 

remove a LIF file lifrm(l) 

remove a message queue, semaphore ipcrm(l) 

remove BIF files or directories bifrm(l) 

remove definition/setting of csh(l) 

remove definition/setting of sh(l) 

remove directory entry; delete unlink(2) 

remove extra new-line characters rmnl(l) 

remove files or directories rm(l) 

remove multiple line-feeds from ssp(l) 

remove nrofl'/troS^, tbl, and eqn deroff'(l) 

remove optional HP-UX products sysrm(lM) 

remove SDF files or directories sdfrm(l) 

remove symbols and debug strip(l) 

remove variable from environment csh(l) 

rename LIF files lifrename(l) 

re-open a stream file; convert/ fopen(3S) 

repair biffsck Bell file system biffsck(lM) 

repair fsck file system fsck[HFS](lM) 

repair fsck file system fsck[SDF](lM) 

repair sdff'sck SDF file system sdffsck(lM) 

repeat execute command more than csh(l) 

repeated lines in a file uniq(l) 

repetitive loop csh(l) 

report CPU time used clock(3C) 

report error information on last err(l) 

report inter-process ipcs(l) 



-49- 



Permuted Index 



iostat 

bifdf 

df 

blocks sdfdf 

ps 

iiniq 

wait wait for process Jind 

vmstat 

stream fseek, rewind, ftell 

/Ipshut, Ipmove start/stop the LP 

hpib status_wait wait until the 

accept, reject allow/prevent LP 

the LP request scheduler and move 

Ip, cancel send/cancel 

vtdaemon respond to vt 

io_spced_ctl inform system of 

lock 

io reset 

vtdaemon 
Define interface parallel poll 

hpib_card ppoll resp control 

as shell input and execute 

as shell input and execute 

breaksw break from switch and 

or foreach continue 

enclosing for/next loop continue 

INIT, GETC, PEEKC, UNGETC, 

value 

abs 

logname 

gpio_get_status 

hpib bus st atus 

getenv 

return exit function with 

call stat data 

numbers of HP-UX files 

col filter 

rev 

information 

revision get HP-UX 

revck check internal 

pointer in a stream fseek, 

/readdir, telldir, seekdir, 

creat create a new file or 

send submit 

directories 

mail mail, 

file 

directories rm, 

characters from file 

chroot change 

chroot ch£inge 

logarithm, power, square 



report I/O statistics iostat(l) 

report number of free disk blocks bifdf(lM) 

report nimiber of free disk blocks df(lM) 

report number of free SDF disk sdfdf(lM) 

report process status ps(l) 

report repeated lines in a file imiq(l) 

report termination status sh(l) 

report virtual memory statistics vmstat (1) 

reposition a file pointer in a fseek(3S) 

request scheduler and move/ Ipsched(lM) 

requested status condition/ hpib_jstatus_wait(3I) 

requests accept(lM) 

requests /Ipmove start/stop Ipsched(lM) 

requests to an LP line printer lp(l) 

requests vtdaemon(lM) 

required transfer speed io speed ctl{31) 

reserve a terminal lock(l) 

reset an I/O interface io reset(3I) 

respond to vt requests vtdaemon(lM) 

response hpib_ppoll resp ctl hpib_ppoll resp_ctl(3I) 

response to parallel poll on/ hpib_card ^ppoll resp(3I) 

resulting commands /arguments csh(l) 

resulting commands /arguments sh(l) 

resume after endsw csh{l) 

resume execution of nearest while csh(l) 

resume next iteration of sh(l) 

RETURN, ERROR, compile, step,/ regexp(5) 

return exit function with return sh(l) 

return integer absolute value abs(3C) 

return login name of user logname(3X) 

return status lines of GPIO card gpio_get__status(3I) 

return status of HP-IB interface hpib_bus_status(3I) 

return value for environment name getenv(3C) 

return value sh(l) 

returned by stat/fstat system stat(5) 

rev reverse lines of a file rev(l) 

revck check internal revision revck (IM) 

reverse line-feeds and backspaces col(l) 

reverse lines of a file rev(l) 

revision get HP-UX revision revision(l) 

revision information revision(l) 

revision numbers of HP-UX files revck(lM) 

rewind, ftell reposition a file fseek(3S) 

rewinddir, closedir directory/ directory(3C) 

rewrite an existuig one creat(2) 

RJEjobs send(l) 

rm, rmdir remove files or rm(l) 

rmail send mail to users or read mail(l) 

rmdel remove a delta from an SCCS rmdel(l) 

rmdir remove files or rm(l) 

rmdir remove a directory file rmdir (2) 

rmnl remove extra new-line rmnl(l) 

root directory chroot(2) 

root directory for a conunand chroot(lM) 

root functions /sqrt exponential, exp(3M) 
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mark/unmark volume as HP-UX 

HP-TIX root volume 

pathalias electronic address 

mfrtO.o execution startup 

expression compile and match 

tputs emulate /etc/termcap access 

standard/restricted command/ sh, 

priority 

realtime priority 

nice 

logouts, and quits nohup 

runacct 

/prctmp, prdaily, prtacct, 

/graphics information for 

for CRT graphics devices 

editing activity 

system savecore 

operating system 

/set real, effective, and 

allocation brk, 

input conversion, read from/ 

bfs big file 

awk text pattern 

change the delta commentary of an 

comb combine 

delta make a delta (change) to an 

sact print current 

get get a version of an 

prs print and summarize an 

rmdel remove a delta from an 

compare two versions of an 

sccsfile format of 

unget imdo a previous get of an 

val validate 

admin create and administer 

what identify files for 

an sees file 

/Ipmove start/stop the LP request 

clear clear terminal 

package curses eRT 

editor based on ex vi 

inittab 

system initialization shell 

osck check integrity of OS in 

sdfls, sdfll list contents of 

sdfmkdir make an 

sdfdf report number of free 

sdfchmod change mode of an 

change owner or group of an 

check, interactive/ sdffsck 

sdffsdb examine/modify an 

sdfrm, sdfrmdir remove 

description 



root volume rootmark rootm£irk(lM) 

rootmark mark/unmark volume as roolmark(iM) 

router pathalias(l) 

routines /mcrtO.o, frtO.o, crtO(3) 

routines /step, advance regular regexp(5) 

routines /tgetstr, tgoto, termcap(3X) 

rsh shell, the sh(l) 

rtprio change or read realtime rtprio(2) 

rtprio execute process with rtprio(l) 

run a command at low priority nice(l) 

run a command immune to hangups, nohup(l) 

run daily accounting nmacct(lM) 

runacct run daily accoimting runacct(lM) 

runacct, shutacct, startup,/ acctsh(lM) 

CRT graphics devices graphics(7) 

CRT graphics information graphics(7) 

sact print current SeeS file sact(l) 

save a core dump of the operating savecore(lM) 

savecore save a core dump of the savecore(lM) 

saved user and group IDs setresuid(2) 

sbrk change data segment space brk(2) 

scanf, fscanf, sscanf formatted scanf(3S) 

scanner bfs(l) 

scanning and processing language awk(l) 

sees delta cdc cdc(l) 

sees deltas comb(l) 

sees file delta(l) 

sees file editing activity sact(l) 

sees file get(l) 

sees file prs(l) 

sees file rmdel(l) 

sees file sccsdiff sccsdifr(l) 

sees file sccsfile(4) 

sees file unget(l) 

sees file val(l) 

sees files admin(l) 

sees information what(l) 

sccsdiff compare two versions of sccsdiff (1) 

sccsfile format of SeCS file sccsfile(4) 

scheduler and move requests Ipsched(lM) 

screen clear(l) 

screen handling and optimization curses(3X) 

screen-oriented (visual) display vi(l) 

script for the init process inittab(4) 

scripts /bcheckrc, re, powerfail brc(lM) 

SDF boot area(s) osck(lM) 

SDF directories sdfls(l) 

SDF directory sdfmkdir(l) 

SDF disk blocks sdfdf(lM) 

SDF file sdfchmod(l) 

SDF file sdfchown, sdfchgrp sdfchown(l) 

SDF file system consistency sdffsck(lM) 

SDF file system sdffsdb(lM) 

SDF files or directories sdfrm(l) 

sdf structured directory format sdf(4) 
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sdfBnd find files in an 

osmsirk mark 

link, or move files to/from an 

an SDF file sdfchown, 

file 

or group of an SDF file 

or move files to/from an SDF/ 

disk blocks 

system 

consistency check, interactive/ 

file system 

Directory Format volume 

directories sdfls, 

files to/from an SDF/ sdfcp, 

directories 

to/from an SDF/ sdfcp, sdfln, 

or directories 

directories sdfrm, 

program 

grep, egrep, fgrep 

bsearch binary 

accounting file(s) acctcom 

Isearch, Ifind linear 

hash remember command location in 

hcreate, hdestroy manage hash 

tdelete, twalk manage binary 

disksecn calculate default disc 

size print 

dialups, d passwd dialup 

/mrand48, jrand48, srand48, 

move read/write file pointer; 

opendir, readdir, telldir, 

memchmd change memory 

memvary modify 

process address space or 

memadvise advise OS about 

shmget get shared memory 

brk, sbrk change data 

two sorted files comm 

multiplexing 

file cut cut out 

semctl 

semop 

ipcrm remove a message queue, 

files lockf provide 

semget get set of 

operations 



group of processes kill 

hpib send cmnd 

mail, rmail 



SDF system sdfiind(l) 

SDF voltune boot area as/ osm£irk{lM) 

SDF voliune /sdfln, sdfmv copy, sdfcp(l) 

sdfchgrp change owner or group of sdfchown(l) 

sdfchmod change mode of an SDF sdfchmod(l) 

sdfchown, sdfchgrp change owner sdfchown(l) 

sdfcp, sdfln, sdfmv copy, link, sdfcp(l) 

sdfdf report nmnber of free SDF sdfdf(lM) 

sdffind find files in an SDF sdSind(l) 

sdffsck SDF file system sdffsck(lM) 

sdffsdb examine/modify an SDF sdffsdb(lM) 

sdfinit initialize Structured sdfinit[SDF](lM) 

sdfll list contents of SDF sdfls(l) 

sdfln, sdfmv copy, link, or move sdfcp(l) 

sdfls, sdfll list contents of SDF sdfls(l) 

sdfmkdir make an SDF directory sdfmkdir(l) 

sdftnv copy, link, or move files sdfcp(l) 

sdfrm, sdfrmdir remove SDF files sdfrm(l) 

sdfrmdir remove SDF files or sdfrm(l) 

sdiff side-by-side difference sdiff ( 1 ) 

search a file for a pattern grep(l) 

search a sorted table bsearch(3C) 

search ajid print process acctcom(l) 

search and update lsearch(3C) 

search path sh(l) 

search tables hsearch, hsearch(3C) 

search trees tsearch, tfind, tsearch(3C) 

section sizes disksecn(lM) 

section sizes of object files size(l) 

security control dialups(4) 

sed strecim text editor sed(l) 

seed48, lcong48 generate/ drand48(3C) 

seek Iseek lseek(2) 

seekdir, rewinddir, closedir/ directory{3C) 

segment access modes memchmd(2) 

segment length memvary(2) 

segment /memulck lock/unlock memlck(2) 

segment reference patterns memadvise(2) 

segment shmget(2) 

segment space allocation brk(2) 

select or reject lines common to comm(l) 

select synchronous I/O select(2) 

selected fields of each line of a cut(l) 

semaphore control operations semctl(2) 

semaphore operations semop(2) 

semaphore set or shared memory id ipcnn(l) 

semaphores and record locking on lockf(2) 

semaphores semget(2) 

semctl semaphore control semctl(2) 

semget get set of semaphores semget (2) 

semop semaphore operations semop(2) 

send a signal to a process or a kill(2) 

send command bytes over HP-IB hpib_send cmnd(3I) 

send mail to users or retid mail mail(l) 

send submit RJE jobs send(l) 
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signal to a process kill 

line printer Ip, cancel 

8-bit/ col^eq_8 collating 

modem asynchronous 

hpib_spoll conduct a 

calendar reminder 

tcio Command 

alarm 

umask 

gpio set_ctl 

sigsetmask 

execution env 

times utime 

irniask 

setgroups 

sethostname 

semget get 

system hostname 

remove a message queue, semaphore 

new files mnask 

new files umask 

setpgrp, setpgrp2 

user and/ setresuid, setresgid 

arguments 

arguments 

getprivgrp, setprivgrp get and 

setprivgrp 

tabs 

and line discipline getty 

date print and 

sip 

port stty 

stime 

on special file io_eol_ctl 

login time profile 

setuid, setgid 

ulimit get and 

io_width ctl 

to a stream file 

set 

set 

variable 

/getfsspec, getfsfile, getfstype, 

setuid, 

getgrent, getgrgid, getgrnam. 



interval timer getitimer, 

encryption crypt, 

mnttab 

group ID 

setpgrp, 

attributes for group getprivgrp, 

for group 



send termination or specified csh(l) 

send/cancel requests to an LP lp(i) 

sequence table for languages with col seq_8(4) 

serial modem line control modem(7) 

serial poll on HP-IB bus hpib_spoll(3I) 

service calendar(l) 

Set 80 Cartridge Tape Utility tcio(l) 

set a process's alarm clock alarm(2) 

set and get file creation mask umask(2) 

set control lines on GPIO card gpio__set_ctl(3I) 

set current signal mask sigsetmask(2) 

set environment for command env(l) 

set file access and modification utime(2) 

set file-creation mode mask umask(l) 

set group access list setgroups(2) 

set name of host cpu sethostname(2) 

set of semaphores semget(2) 

set or print name of current host hostname(l) 

set or shared memory id ipcrm ipcrm(l) 

set permissions mask for creating csh(l) 

set permissions mask for creating sh(l) 

set process group ID setpgrp(2) 

set real, effective, and saved setresuid(2) 

set set/define flags and csh(l) 

set set/define flags and sh(l) 

set special attributes for group getprivgrp(2) 

set special attributes for group setprivgrp(lM) 

set tabs on a terminal tabs(l) 

set terminal type, modes, speed, getty(lM) 

set the date date(l) 

set the options for a printer slp(l) 

set the options for a terminal stty(l) 

set time and date stime(2) 

set up read termination character io eol ctl(3I) 

set up user's environment at profile(4) 

set user and group IDs setuid(2) 

set user limits ulimit(2) 

set width of data path io_width ctl(3I) 

setbuf, setvbuf assign buffering setbuf(3S) 

set/define flags and arguments csh(l) 

set/define flags and arguments sh(l) 

setenv define environment csh(l) 

setfsent, endfsent get file/ getfsent(3X) 

setgid set user and group IDs setuid(2) 

setgrent, endgrent, fgetgrent get/ getgrent(3C) 

setgroups set group access list setgroups(2) 

sethostname set name of host cpu sethostname(2) 

setitimer get/set value of getitimer(2) 

setjmp, longjmp non-local goto setjmp(3C) 

setkey, encrypt generate hashing crypt(3C) 

setmnt establish mount table setmnt(lM) 

setpgrp, setpgrp2 set process setpgrp(2) 

setpgrp2 set process group ID setpgrp(2) 

setprivgrp get and set special getprivgrp(2) 

setprivgrp set special attributes setprivgrp(lM) 
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getpwent, getpwuid, getpwnfim, 

and saved user and/ setresuid, 

effective, and saved user and/ 

languages with 8-bit character 

time gettimeofday, 

gettydefs speed and terminal 

IDs 

/getutid, getutline, pututline, 

stream file setbuf, 

of one/ paste merge ssune lines of 

a machine-independent/ sputl, 

standard/restricted commcmd/ 

shmctl 

a message queue, semaphore set or 

shmop 

shmget get 

time print accumulated 

chsh change default login 

C-like syntax csh a 

system issue a 

login terminate login 

logout terminate login 

commands eval read argimients as 

commands eval read argimients as 

/shutacct, startup, turnacct 

powerfail system initialization 

command programming/ sh, rsh 

exit exit 

exit exit 

onintr specify 

position to left shift 

next lower position shift 

one position to left 

to next lower position 

operations 



alloc 

groups 

as if a command type 

uusnap 

/prdaily, prtacct, runacct, 

system fsclean determine 

sdiff 

login 

sigvector software 

sigsetmask set current 

pause suspend process until 

execute command upon receipt of 

what to do upon receipt of a 

receipt of a signal 

sigspace assvire sufficient 

send termination or specified 



setpwent, endpwent, fgetpwent get/ getpwent(3C) 

setresgid set real, effective, setresuid(2) 

setresuid, setresgid set real, setresuid(2) 

sets /sequence table for col seq 8(4) 

settimeofday get/set date and gettimeofday (2) 

settings used by getty gettydefs(4) 

setuid, setgid set user £ind group setuid(2) 

setutent, endutent, utmpname/ getut(3C) 

setvbuf assign buffering to a setbuf (3S) 

several files or subsequent lines paste(l) 

sgetl access long integer data in sputl(3X) 

sh, rsh shell, the sh(l) 

shared memory control operations shmctl(2) 

shared memory id ipcrm remove ipcrm(l) 

shared memory operations shmop(2) 

shared memory segment shmget(2) 

shell and children process times sh(l) 

shell chsh(l) 

shell (conunand interpreter) with csh(l) 

shell command system(3S) 

shell csh(l) 

shell csh(l) 

shell input and execute resulting csh(l) 

shell input suid execute resulting sh(l) 

shell procedures for accounting acctsh(lM) 

shell scripts brc, bcheckrc, re, brc(lM) 

shell, the standard/restricted sh(l) 

shell with exit status csh(l) 

shell with exit status sh(l) 

shell 's treatment of interrupts csh ( 1 ) 

shift arjv members one csh(l) 

shift positional parsmieters to sh(l) 

shift shift argv members csh(l) 

shift shift positional parameters sh(l) 

shmctl shared memory control shmctl(2) 

shmget get shared memory segment shmget(2) 

shmop shared memory operations shmop(2) 

show dynamic memory usage csh(l) 

show group memberships groups(l) 

show interpretation of name sh(l) 

show snapshot of the UUCP system uusnap(lM) 

shutacct, startup, turnacct shell/ acctsh(lM) 

shutdown status of specified file fsclean(lM) 

shutdown terminate all processing shutdown(lM) 

side-by-side difference program sdiff(l) 

sigblock block signals sigblock(2) 

sign on login(l) 

signal facilities sigvector(2) 

signal mask sigsetmask(2) 

signal pause(2) 

signjil trap sh(l) 

signal signal specify signal(2) 

signal specify what to do upon signal(2) 

signal stack space sigspace(2) 

signal to a process kill csh(l) 
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processes kill send a 

/atomically release blocked 

sigblock block 

ssignal, gsignal software 

gamma, 

blocked signals and wait for/ 

mask 

stack space 

facilities 

rand, srand 

adjust 

atan2 trigonometric fimctions 

functions 

ulimit impose file 

object files 

calculate default disc section 

size print section 

interval 

interval 

file descriptor to a specific 

current user ttyslot find the 

uusnap show 

pg file perusal filter for 

sigvector 

ssignal, gsignal 

sort 

qsort quicker 

tsort topological 

or reject lines common to two 

bsearch binary search a 

program whereis locate 

input 

soinrce define 

extract error messages from C 

brk, sbrk change data segment 

£ifter allocating data and stack 

memfree allocate and free address 

lock/unlock process address 

assure sufficient signal stack 

expand, unexpand expand tabs to 

(call terminal) ct 

memory efficient way vfork 

mknod create 

getprivgrp get 

/setprivgrp get and set 

setprivgrp set 

mknod create a 

up read termination character on 

Issf list a 

mksf make a 

insf install 

2621-series terminals hp handle 

mknod make a directory, or a 



signal to a process or a group of kill(2) 

signals and wait for interrupt sigpause(2) 

signals sigblock(2) 

signals ssignal(3C) 

signgam log gamma function gamma(3M) 

sigpause atomically release sigpau8e(2) 

sigsetmask set current signal sigsetmask(2) 

sigspace assure sufficient signal sigspace(2) 

sigvector software signal sigvector(2) 

simple random-number generator rand(3C) 

simple text formatter adjust(l) 

sin, cos, tan, asin, acos, atan, trig(3M) 

sinh, cosh, tanh hyperbolic sinh(3M) 

size limit for child processes sli(l) 

size print section sizes of size(l) 

sizes disksecn disksecn(lM) 

sizes of object files size(l) 

sleep suspend execution for an sleep(l) 

sleep suspend execution for sleep(3C) 

slot dup2 duplicate an open dup2(2) 

slot in the utmp file of the ttyslot(3C) 

sip set the options for a printer slp(l) 

snapshot of the UUCP system uusnap(lM) 

soft-copy terminals Pg(l) 

software signal facilities sigvector(2) 

software signals ssignal(3C) 

sort and/or merge files sort(l) 

sort qsort(3C) 

sort sort £ind/or merge files sort(l) 

sort tsort(l) 

sorted files comm select conmi(l) 

sorted table bsearch(3C) 

source, binary, £ind/or manual for whereis(l) 

source define source for command csh(l) 

source for command input csh(l) 

source into a file mkstr mkstr(l) 

space allocation brk(2) 

space /lock process into memory, datalock(3C) 

space memallc, memallc(2) 

space or segment memlck, memulck memlck(2) 

space sigspace sigspace(2) 

spaces, and vice versa expand(l) 

spawn getty to a remote terminal ct(l) 

spawn new process in a virtual vfork(2) 

special and fifo files mknod(lM) 

special attributes for group getprivgrp(l) 

special attributes for group getprivgrp(2) 

special attributes for group setprivgrp(lM) 

special file entry mknod(4) 

special file io_eol ctl set io eol ctl(3I) 

special file lssf(l) 

special file mksf(l) 

special files insf(l) 

special fimctions of HP 2640 and hp(l) 

special or ordinary file mknod(2) 
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£in open file descriptor to a 

fspec format 

nnalias discard 

determine shutdown status of 

hpib abort stop activity on 

ftnmcate truncate a file to a 

goto continue execution on 

kill send termination or 

interrupts onintr 

of a signal signal 

getty set terminal type, modes, 

by getty gettydefs 

system of required trsinsfer 

hashcheck find spelling errors 

errors spell, hashmake, 

hashmake, spellin, hsishcheck find 

split 

csplit context 

mantissa and/ frexp, Idexp, modf 

oscp copy, create, append to, 

uucleein uucp 

by transaction uuls list 

mklp configure the LP 

Ipadmin configure the LP 

printf, fpriatf, 

with/ printmsg, fprintmsg, 

data in a machine-independent/ 

isql ALLBASE/HP-UX interactive 

power,/ exp, log, loglO, pow, 

exponential, logarithm, power, 

generator rand, 

/nrand48, mrand48, jrand48, 

/allow interface to enable 

conversion, read/ scEinf, fscanf, 

from output 

dirs print the directory 

I)opd pop directory 

pushd push directory 

memory, after allocating data and 

sigspace assure sufiicient signal 

stream file package stdio 

read read line from 

communication package ftok 

programming/ sh, rsh shell, the 

Ipsched, Ipshut, Ipmove 

frtO.o, mfrtO.o execution 

prtacct, runacct, shutacct, 

system call 

case label in a switch 

default label default in switch 

endsw terminate switch 

switch define switch 



specific slot dup2 duplicate dup2(2) 

specification in text files fspec(4) 

specified alias csh(l) 

specified file system fsclean fsclean(lM) 

specified HP-IB bus hpib_abort(3I) 

specified length truncate, truncate{2) 

specified line csh(l) 

specified signal to a process csh(l) 

specify shell's treatment of csh(l) 

specify what to do upon receipt signal(2) 

speed, and line discipline getty(lM) 

speed and terminal settings used gettydefs(4) 

speed io speed ctl inform io speed ctl(3I) 

spell, hashmake, spellin, spell(l) 

spellin, hashcheck find spelling spell(l) 

spelling errors spell, spell(l) 

split a file into pieces split(l) 

split csplit(l) 

split floating-point into frexp(3C) 

split operating system oscp(lM) 

split split a file into pieces split(l) 

spool directory clean-up uuclean(lM) 

spooled uucp transactions grouped uuls(lM) 

spooler subsystem niklp(lM) 

spooling system Ipadmin(lM) 

sprintf print formatted output printf(3S) 

sprintmsg print formatted output printmsg(3C) 

sputl, sgetl access long integer sputl(3X) 

SQL interface isql(l) 

sqrt exponential, logarithm, exp(3M) 

square root functions /pow, sqrt exp(3M) 

srand simple random-number rand(3C) 

srand48, seed48, lcong48 generate/ drand48(3C) 

SRQ line on HP-IB hpib_rqst_srvce(3I) 

sscanf formatted input scanf(3S) 

ssignal, gsignal software signals ssignal(3C) 

ssp remove multiple line-feeds ssp(l) 

stack csh(l) 

stack csh(l) 

stack csh(l) 

stack space /lock process into datalock(3C) 

stack space sigspace(2) 

standard buff"ered input/output stdio(3S) 

standard input sh(l) 

standard interprocess stdipc(3C) 

standard/restricted command sh(l) 

st£irt/stop the LP request/ Ipsched(lM) 

startup routines /mcrtO.o, crt0(3) 

startup, tumacct shell/ /prdaily, acctsh(lM) 

stat data returned by stat/fstat stat(5) 

stat, fstat get file status stat(2) 

statement csh(l) 

statement csh(l) 

statement csh(l) 

statement csh(l) 
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stat data returned by 

systems checklist 

print hash table effectiveness 

iostat report I/O 

ustat get file system 

vmstat report virtual memory 

virtual memory performance 

/wait until the requested 

exit exit shell with exit 

notify user of change in job 

Ipstat print LP 

feof, clearerr, fileno stream 

uustat uucp 

communication facilities 

gpio_get_jstatus return 

hpib_bus__status return 

fsclean determine shutdown 

ps report process 

exit exit shell with exit 

process and report termination 

Stat, fstat get file 

input/output stream file package 

/UNGETC, RETURN, ERROR, compile, 

bus hpib_abort 

optional reboot stopsys 

wait wait for child process to 

with optional reboot 

prealloc preallocate disk 

prealloc preallocate fast disk 

vsoff advise OS about backing 

vsadv advise system about backing 

strcpy, stmcpy, strlen, strchr,/ 

/stmcmp, strcpy, stmcpy, strlen, 

strlen, strchr,/ strcat, strncat, 

string/ strcmpS, stmcmpS, 

strncmpl6 non-ASCII string/ 

strcat, strncat, strcmp, stmcmp, 

/strchr, strrchr, strpbrk, strspn, 

fclose, fflush close or flush a 

/freopen, fdopen open or re-open a 

buffered binary input/output to a 

getw get character or word from a 

standard buffered input/output 

input conversion, read from 

setvbuf assign buffering to a 

a stream file; convert file to 

reposition a file pointer in a 

gets, fgets get a string from a 

putw put character or word on a 

puts, fputs put a string on a 

ferror, feof, clearerr, fileno 

sed 

push character back into input 

long integer and base-64 ASCII 



stat/fstat system call stat(5) 

static information about the file checklist (4) 

statistics hashstat csh(l) 

statistics iostat(l) 

statistics ustat(2) 

statistics vnistat(l) 

statistics vstat collect vstat(lM) 

status condition becomes true hpib status_wait(3I) 

status csh(l) 

status notify csh(l) 

status information Ipstat(l) 

status inquiries ferror, ferror(3S) 

status inquiry and job control uustat(l) 

status ipcs report inter-process ipcs(l) 

status lines of GPIO card gpio_get_status(3I) 

status of HP-IB interface hpib_bus_status(3I) 

status of specified file system fsclean(lM) 

status ps(l) 

status sh(l) 

status wait wait for sh(l) 

status stat(2) 

stdio standard buffered stdio(3S) 

step, advance regular expression/ regexp(5) 

stime set time and date stime(2) 

stop activity on specified HP-IB hpib__abort(3I) 

stop operating system with stopsys(lM) 

stop or terminate wait(2) 

stopsys stop operating system stopsys(lM) 

storage prealloc(l) 

storage prealloc(2) 

store devices vson, vson(2) 

store usage vsadv(2) 

strcat, strncat, strcmp, stmcmp, string(3C) 

strchr, strrchr, strpbrk, strspn,/ string(3C) 

strcmp, strncmp, strcpy, stmcpy, string(3C) 

strcmpl6, stmcmpl6 non-ASCII nl string(3C) 

strcmpS, stmcmpS, strcmpl6, nl string(3C) 

strcpy, stmcpy, strlen, strchr,/ string(3C) 

strcspn, strtok character string/ string(3C) 

stream fclose(3S) 

stream file; convert file to/ fopen(3S) 

stream file fread, fwrite fread(3S) 

stream file /getchar, fgetc, getc(3S) 

stream file package stdio stdio(3S) 

stream file /sscanf formatted scanf(3S) 

stream file setbuf, setbuf(3S) 

stream /fdopen open or re-open fopen(3S) 

stream fseek, rewind, ftell fseek(3S) 

stream gets(3S) 

stream putc, putchar, ^utc, putc(3S) 

stream puts(3S) 

stream status inquiries ferror(3S) 

stream text editor sed(l) 

stream ungetc ungetc(3S) 

string /164a convert between a641(3C) 
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strcmpl6, strncmpl6 non-ASCII 

tzset convert date and time to 

convert floating-point number to 

gets, fgets get a 

puts, fputs put a 

strspn, strcspn, strtok character 

/atof, nl strtod, nl atof convert 

cvtmmi convert 

strtol, atol, atoi convert 

strings in a object, or other/ 

catalogs findstr find 

strings find the printable 

information 

/strcmp, strncmp, strcpy, stmcpy, 

stmcpy, strlen, strchr,/ strcat, 

strchr,/ strcat, strncat, strcmp, 

strcmpS, stmcmpS, strcmpl6, 

non-ASCII string/ strcmpS, 

/strncat, strcmp, strncmp, strcpy, 

/stmcpy, strlen, strchr, strrchr, 

/strcpy, stmcpy, strlen, strchr, 

/strlen, strchr, strrchr, strpbrk, 

convert string to/ 

strpbrk, strspn, strcspn, 

to integer 

nlist nlist 

nlist nlist 

description sdf 

volume sdfinit initialize 

terminal port 

Version 6/PWB compatibility 

user 

send 

variable names to environment of 

/same lines of several files or 

fileuEime alias 

diagnostic event logger for I/O 

diagO diagnostic interface to I/O 

mklp configure the LP spooler 

sigspace assure 

count of a file 

prs print and 

du 

accoimting/ acctcms command 

sync update the 

sync update 

su become 

MPE/RTE-style message catalog 

hpnls HP Native Language 

sleep 

sleep 

pause 

swab 



string collation /strncmpS, nl string(3C) 

string /daylight, tzname, ctime(3C) 

string ecvt, fcvt, gcvt, nl gcvt ecvt(3C) 

string from a stream gets(3S) 

string on a stream puts(3S) 

string operations /strpbrk, string(3C) 

string to double-precision number strtod(3C) 

string to floating point niunber cvtnirai(3C) 

string to integer strtol(3C) 

strings find the printable strings(l) 

strings for inclusion in message findstr(l) 

strings in a object, or other/ strings(l) 

strip remove symbols and debug strip(l) 

strlen, strchr, strrchr, strpbrk,/ string(3C) 

strncat, strcmp, strncmp, strcpy, string(3C) 

strncmp, strcpy, stmcpy, strlen, string(3C) 

stmcmpl6 non-ASCII string/ nl string(3C) 

stmcmpS, strcmpie, stmcmpl6 nl string(3C) 

stmcpy, strlen, strchr, strrchr,/ string(3C) 

strpbrk, strspn, strcspn, strtok/ string(3C) 

strrchr, strpbrk, strspn,/ string(3C) 

strspn, strcspn, strtok character/ string(3C) 

strtod, atof, nl_strtod, nl atof strtod(3C) 

strtok character string/ /strrchr, string(3C) 

strtol, atol, atoi convert string strtol(3C) 

structure format nlist(4) 

structure format nlist(4) 

structured directory format sdf (4) 

Structured Directory Format sdfinit[SDF](lM) 

stty, gtty control device stty(2) 

stty set the options for a stty(l) 

stty terminal interface for sttyv6(7) 

su become super-user or another su(l) 

submit RJE jobs send(l) 

subsequent commands /export sh(l) 

subsequent lines of one file paste(l) 

substitute command and/or csh(l) 

subsystem, delog delog(lM) 

subsystem diag0(7) 

subsystem mklp(lM) 

sufiicient signal stack space sigspace(2) 

sum print checksum and block simi(l) 

summarize an SCCS file prs(l) 

summarize disk usage du(l) 

summary from per-process acctcms(lM) 

super block sync(lM) 

super-block sync(2) 

super-user or another user su(l) 

support catread catread(3C) 

Support (NLS) Model hpnls(5) 

suspend execution for an interval sleep(l) 

suspend execution for interval sleep(3C) 

suspend process until signal pause(2) 

swab swap bytes swab(3C) 

swap bytes swab(3C) 
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paging/swapping swapon add a 

interleaved paging/swapping 

for paging and swapping 

additional device for paging and 

breaksw break from 

case label in a 

default label default in 

endsw terminate 

switch define 

clrsvc clear x25 

libraries ranlib archive 

nm print name list 

cdb, fdb, pdb C, FORTRAN, Pascal 

strip remove 

syncer periodically 



system integrity 

state with its state on/ fsync 

select 

(command interpreter) with C-like 

error messages perror, errno, 

perror, errno, sys errlist, 

products 

vsadv advise 

autobkup backup or archive file 

backup backup or archive file 

bifiind find files in a BIF 

biftnkfs construct a Bell file 

Stat data returned by stat/fstat 

errno error indicator for 

unlink exercise link and unlink 

uux UNIX system to UNIX 

interactive/ biffsck Bell file 

interactive repair fsck file 

interactive repair fsck file 

interactive/ sdffsck SDF file 

console 

uulog, uuname UNIX system to UNIX 

types primitive 

biffsdb Bell file 

fsdb file 

/setfsent, endfsent get file 

form error log dmesg collect 

ems Extended Memory 

errfile 

errno, sys errlist, sys nerr 

uupick public UNIX system to UNIX 

shutdown status of specified file 

fsdb examine/modify file 

hier file 

set or print name of current host 

brc, bcheckrc, re, powerfail 

syncer periodically sync for file 



swap device for interleaved swapon[HFS](2) 

swapon add a swap device for swapon [HFS] (2) 

swapon enable additional device swapon[HFS](lM) 

swapping swapon enable swapon[HFS](lM) 

switch and resimie after endsw csh(l) 

switch define switch statement csh(l) 

switch statement csh(l) 

switch statement csh(l) 

switch statement csh(l) 

switch statement csh(l) 

switched virtual circuit clrsvc(lM) 

symbol table format for object ranlib(4) 

(symbol table) of object file nm(l) 

symbolic debugger cdb(l) 

symbols and debug information strip(l) 

sync for file system integrity syncer(lM) 

sync update super-block sync(2) 

sync update the super block sync(lM) 

syncer periodically sync for file syncer(lM) 

synchronize a file's in-core fsync(2) 

synchronous I/O multiplexing select(2) 

syntax csh a shell csh(l) 

sys_errlist, sys nerr system perror(3C) 

sys nerr system error messages perror (3C) 

sysrm remove optional HP-UX sysrm(lM) 

system about backing store usage vsadv(2) 

system autobkup(lM) 

system backup(lM) 

system biffind(l) 

system bifmkfs(lM) 

system call stat(5) 

system calls errno(2) 

system calls link, link(lM) 

system command execution uux(l) 

system consistency check and biffsck(lM) 

system consistency check and fsck[HFS](lM) 

system consistency check and fsck[SDF](lM) 

system consistency check, sdffsck(lM) 

system console interface console(7) 

system copy uucp, uucp(l) 

system data types types(5) 

system debugger biffsdb(lM) 

system debugger fsdb[HFS](lM) 

system descriptor file entry getfsent(3X) 

system diagnostic messages to dmesg(lM) 

System ems(2) 

system error logging file errfile(4) 

system error messages perror, perror(3C) 

system file copy uuto, uuto(l) 

system fsclean determine fsclean(lM) 

system fsdb[SDF](lM) 

system hierarchy hier(5) 

system hostname hostname(l) 

system initialization shell/ brc(lM) 

system integrity syncer(lM) 
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isl initial 

Ipadmin configure the LP spooling 

Isdev list device drivers in the 

interactive message processing 

description osmgr operating 

mkfs construct a file 

mkrs construct a recovery 

moimt mount a file 

mnoimt mount and dismount file 

umount mount and unmount file 

newfs construct a new file 

io speed ctl inform 

change to different operating 

append to, split operating 

vt login to another 

times print accumulated user and 

reboot reboot the 

reboot boot the 

reconfig configure an HP-UX 

uconfig 

save a core dump of the operating 

sdffind find files in an SDF 

examine/modify an SDF file 

ustat get file 

mnttab moimted file 

cu call another (UNIX) 

execution uux UNIX 

uucp, uulog, uuname UNIX 

uuto, uupick public UNIX 

tunefs tune up an existing file 

umount unmount a file 

uname get name of currentHP-UX 

uusnap show snapshot of the UUCP 

fs format of file 

fs format of 

who who is on the 

stopsys stop operating 

static information about the file 

bsearch binary search a sorted 

rehash recompute internal hash 

hashstat print hash 

tztab time zone adjustment 

col seq_8 collating sequence 

ranlib archive symbol 

master master device information 

setmnt establish mount 

mnttab mounted file system 

nm print name list (symbol 

disable use of internal hash 

tbl format 

hdestroy manage hash search 

tabs set 

expand, imexpand expand 



system issue a shell command system(3S) 

system loader isl(lM) 

system Ipadmin(lM) 

system Isdev(l) 

system mailx mailx(l) 

system manager package osmgr(lM) 

system nikfs[HFS](lM) 

system mkrs(lM) 

system mount(2) 

system mount, mount[HFS](lM) 

system mount, mount[non-HFS](lM) 

system newfs[HFS](lM) 

system of required transfer speed io_speed ctl(3I) 

system or version chsys chsys(lM) 

system oscp copy, create, oscp(lM) 

system over Ian vt(l) 

system process times sh(l) 

system reboot(lM) 

system reboot(2) 

system reconfig(lM) 

system reconfiguration uconfig(lM) 

system savecore savecore(lM) 

system sdffind(l) 

system sdffsdb sdffsdb(lM) 

system statistics ustat(2) 

system table mnttab(4) 

system; terminal emulator cu(l) 

system to UNIX system command uux(l) 

system to UNIX system copy uucp(l) 

system to UNIX system file copy uuto(l) 

system tunefs[HFS](lM) 

system umount(2) 

system uname(2) 

system uusnap(lM) 

system volume fs[HFS](4) 

system volume fs[SDF](4) 

system who(l) 

system with optional reboot stopsys(lM) 

systems checklist checklist(4) 

table bsearch(3C) 

table csh(l) 

table effectiveness statistics csh(l) 

table for date(l) and ctime(3C) tztab(4) 

table for languages with 8-bit/ col seq_8(4) 

table format for object libraries r£mlib(4) 

table master(4) 

table mnttab setmnt(lM) 

table nmttab(4) 

table) of object file nm(l) 

tables unhash csh(l) 

tables for nroff tbl(l) 

tables hsearch, hcreate, hsearch(3C) 

tabs on a terminal tabs(l) 

tabs set tabs on a terminal tabs(l) 

tabs to spaces, and vice versa expand(l) 
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ctags create a 

file 

write interactively write 

trigonometric/ sin, cos, 

sinh, cosh, 

ct cartridge 

tar 

reblock, translate, £ind copy a 

mt magnetic 

mt magnetic 

disk, flexible disk, or cartridge 

tcio Command Set 80 Cartridge 

deroff remove nroff/trolF, 

Tape Utility 

search trees tsearch, tfind, 

basic 

indicate last logins of users and 

initialization init, 

closedir/ opendir, readdir, 

temporary file tmpnam, 

tmpfile create a 

tempnam create a name for a , 

terminals 

term format of compiled 

terminfo/ captoinfo convert a 

interface blmode 

ct spawn getty to a remote 

terminfo 

getty to a remote terminal (call 

ctermid generate file name for 

tset 

pty pseudo 

general purpose asynchronous 

cu call another (UNIX) system; 

6/PWB compatibility stty 

termio general 

tty controlling 

undial establish an out-going 

lock reserve a 

mesg permit or deny messages to 

stty set the options for a 

clear clear 

gettydefs speed and 

tabs set tabs on a 

tty get the name of the 

ttyname, isatty find name of a 

line discipline getty set 

ttytype data base of 

of HP 2640 and 2621-series 

file perusal filter for soft-copy 

term conventional names for 



tags file ctags(l) 

tail deliver the last part of a tail(l) 

(talk) to another user write(l) 

tan, asin, acos, atan, atan2 trig(3M) 

tanh hjrperbolic functions sinh(3M) 

tape access ct(7) 

tape file archiver tar(l) 

(tape) file dd convert, dd(l) 

tape interface and controls mt(7) 

tape manipulating program mt(l) 

tape media /initialize hard mediainit(l) 

Tape Utility tcio(l) 

tar tape file archiver tar(l) 

tbl, £ind eqn constructs derofF(l) 

tbl format tables for nrofF tbl(l) 

tcio Command Set 80 Cartridge tcio(l) 

tdelete, twalk manage binary tsearch(3C) 

Technical BASIC interpreter basic(l) 

tee pipe fitting tee(l) 

teletypes last, lastb last(l) 

telinit process control init(lM) 

telldir, seekdir, rewinddir, directory(3C) 

tempnam create a name for a tmpnam(3S) 

temporary file tmpfile(3S) 

temporary file tmpnam, tmpnam(3S) 

term conventional names for term(5) 

term file ,. term(4) 

term format of compiled term file term(4) 

termcap description into a captoinfo(lM) 

terminal block mode library blmode(3C) 

terminal (call terminal) ct(l) 

terminal capability data base terminfo(4) 

terminal) ct spawn ct(l) 

terminal ctermid(3S) 

terminal dependent initialization tset(l) 

terminal driver pty(7) 

terminal emulation aterm aterm(l) 

terminal emulator <^u(l) 

terminal interface for Version sttyv6(7) 

terminal interface termio(7) 

terminal interface tty(7) 

terminal line coimection dial, dial(3C) 

terminal lock(l) 

terminal mesg(l) 

terminal port stty(l) 

terminal screen clear(l) 

terminal settings used by getty gettydefs (4) 

terminal tabs(l) 

terminal tty(l) 

terminal ttyname(3C) 

terminal type, modes, speed, and getty(lM) 

terminal types by port ttytype(4) 

terminals /special functions hp(l) 

terminals pg Pg(l) 

terminals term(5) 
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kill 

shutdown 

end 

login 

logout 

exit, _exit 

endsw 

wait for child process to stop or 

determine how last read 

file io eol ctl set up read 

to a process kill send 

wait wait for process and report 

tic 

tput query 

untie 

a termcap description into a 



expression 

ed, red 

ex 

sed stream 

casual users) edit 

newform change or reformat a 

fspec format specification in 

neqn format mathematical 

adjust simple 

programs for lexical anfilysis of 

nroff format 

plock lock process, 

processing language awk 

binary search trees tsearch, 

tgetstr, tgoto, tputs emulate/ 

emulate/ tgetent, tgetnum, 

tgoto, tputs emulate/ tgetent, 

tgetent, tgetnum, tgetflag, 

/tgetnum, tgetflag, tgetstr, 

get/set value of interval 

process times 

modification, and/or change 

system process times 

shell and children process 

user and system process 

get process and child process 

set file access and modification 

/gmtime, asctime, nl asctime, 

a temporary file 
oscp copy, create, append 

/tolower, toupper, _tolower, 

popen, pclose initiate pipe I/O 

sdfmv copy, link, or move files 

toupper, tolower, _toupper, 



terminate a process kill(l) 

terminate all processing shutdown(lM) 

terminate foreach or while loop csh(l) 

terminate login shell csh(l) 

terminate login shell csh(l) 

terminate process exit(2) 

terminate switch statement csh(l) 

terminate wait wait(2) 

terminated io get term reason io get term reason(3I) 

termination character on special io_eol ctl(3I) 

termination or specified signal csh(l) 

termination status sh(l) 

terminfo compiler tic(lM) 

terminfo database tput(l) 

terminfo de-compiler untic(lM) 

terminfo description /convert captoinfo(lM) 

terminfo terminal capability data terminfo(4) 

termio general terminal interface termio(7) 

test condition evaluation command test(l) 

test evaluate conditional csh(l) 

text editor ed(l) 

text editor 6x(l) 

text editor sed(l) 

text editor (variant of ex for edit(l) 

text file newform(l) 

text files fspec(4) 

text for nroff neqn(l) 

text formatter adjust(l) 

text lex generate lex(l) 

text nroff(l) 

text, or data in memory plock(2) 

text pattern scanning and awk(l) 

tfind, tdelete, twalk manage tsearch(3C) 

tgetent, tgetnum, tgetflag, termcap(3X) 

tgetflag, tgetstr, tgoto, tputs termcap(3X) 

tgetnmn, tgetflag, tgetstr, termcap(3X) 

tgetstr, tgoto, tputs emulate/ termcap(3X) 

tgoto, tputs emulate /etc/termcap/ termcap(3X) 

tic terminfo compiler tic(lM) 

timer getitimer, setitimer getitimer(2) 

times get process and child times(2) 

times of file /update access, touch(l) 

times print accmnulated user £ind sh(l) 

times time print accumulated sh(l) 

times times print accimiulated sh(l) 

times times times(2) 

times utime utime(2) 

timezone, daylight, tzname, tzset/ ctime(3C) 

tmpfile create a temporary file tmpfile(3S) 

tmpnam, tempnam create a name for tmpnam(3S) 

to, split operating system oscp(lM) 

toascii translate characters conv(3C) 

to/from a process popen(3S) 

to/from an SDF volimie /sdfhi, sdfcp(l) 

—tolower, toascii translate/ conv(3C) 
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toascii translate/ toupper, 
database access interactive 

cheiracters nl tools_16 

tsort 

acctmerg merge or add 

modification, and/or change/ 

translate/ toupper, tolower, 

tolower, toascii translate/ 

/tgetflag, tgetstr, tgoto, 

ptrace process 

uucp transactions grouped by 

uuls list spooled uucp 

kermit KERMIT-protocol file 

umodem XMODEM-protocol file 

inform system of required 

dd convert, reblock, 

astrn 

atrans 

toupper, tolower, toascii 

NLS nLtoupper, nLtolower 

tr 

of signal 

intrapon disable/enable integer 

trapno hardware 

onintr specify shell's 

ftw walk a file 

twalk manage binary search 

cos, tan, asin, acos, atan, atan2 

command if expression evaluates 

status condition becomes 

length truncate, ftruncate 

file to a specified length 

/pdpll, u3b, u3b5, vax provide 

true, false provide 

memage binary search trees 

initialization 

interface 

terminal 

file of the current user 

types by port 

tunefs 

system 

/runacct, shutacct, startup, 

tsearch, tfind, tdelete, 

file determine file 

truth value about your processor 

discipline getty set terminal 

name as if a command 

ttytype data base of terminal 



tolower, _toupper, _tolower, conv(3C) 

tool /ALLBASE/HP-UX HPIMAGE .... iqucry(l) 

tools to process 16-bit nl tools_16(3C) 

topological sort t8ort(l) 

total accounting files acctmerg(lM) 

touch update access, touch(l) 

toupper, tolower, toascii conv(3C) 

toupper, tolower, _toupper, conv(3C) 

tput query terminfo database tput(l) 

tputs emulate /etc/termcap access/ termcap(3X) 

tr translate characters tr(l) 

trace ptrace(2) 

transaction uuls list spooled uuls(lM) 

transactions grouped by/ uuls(lM) 

transfer program kermit(l) 

transfer program umodem(l) 

transfer speed io-_speed ctl io_^peed ctl(3I) 

translate, and copy a (tape) file dd(l) 

translate assembly language astm(l) 

translate assembly language atrans(l) 

translate characters /tolower, conv(3C) 

translate characters for use with nl conv(3C) 

translate characters tr(l) 

trap execute command upon receipt sh(l) 

trap handler intrapoff, intrapoflF(3m) 

trap numbers trapno(2) 

trapno hardware trap numbers trapno(2) 

treatment of interrupts csh(l) 

tree ftw(3C) 

trees tsearch, tfind, tdelete, tsearch(3C) 

trigonometric functions sin, trig(3M) 

true if execute csh(l) 

true, false provide truth values true(l) 

true /wait until the requested hpib_jstatus_wait(3I) 

truncate a file to a specified truncate(2) 

truncate, ftruncate tnmcate a truncate(2) 

truth value about your processor/ machid(l) 

truth values ,. true(l) 

tsearch, tfind, tdelete, twalk tsearch(3C) 

tset terminal dependent tset(l) 

tsort topological sort tsort(l) 

tty controlling terminal tty(7) 

tty get the name of the terminal tty(l) 

ttyname, isatty find name of a ttyname(3C) 

ttyslot find the slot in the utmp ttyslot(3C) 

ttytype data base of terminsil ttytype(4) 

tune up an existing file system tunefs[HFS](lM) 

tunefs tune up an existing file tunefs[HFS](lM) 

turnacct shell procedures for/ acctsh(lM) 

twalk manage binary search trees tsearch(3C) 

type file(l) 

type /u3b, u3b5, vax provide machid(l) 

type, modes, speed, and line getty(lM) 

type show interpretation of sh(l) 

types by port ttytype(4) 
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types primitive system data 

/n] asctime, timezone, daylight, 

/timezone, daylight, tzname, 

for date(l) and ctime(3C) 

/hp9000s500, hpOOOOsSOO, pdpll, 

about/ /hpQOOOsSOO, pdpll, u3b, 

getpw get name from 



child processes 
mask 

creating new files 

creating new files 

transfer program 

system mount, 

system mount, 



system 

version 

uncompress files, and/ compact, 

/uncompact, ccat compress £ind 

expand data compress, 

ul do 

terminal line connection dial, 

file unget 

and vice versa expand, 

sees file 

input stream 

step, advance/ INIT, CETe, PEEKe, 

hash tables 

srand48, seed48, lcong48 generate 

file 

mktemp make a 

uux UNIX system to 

uulog, uuname UNIX system to 

uupick public UNIX system to 

cu call another 

command execution uux 

uucp, uulog, uuname 

copy uuto, uupick public 

system calls link, 

delete file 

link, imlink exercise link and 

io Jock, io_unlock lock and 

umount 

mount, umoimt mount and 

pack, peat, 

media upm 

visible or/ vis, inv make 

of flags and arguments 



types primitive system data types types(5) 

types types(5) 

tzname, tzset convert date and/ ctime(3C) 

tzset convert date and time to/ ctime(3C) 

tztab time zone adjustment table tztab(4) 

u3b, u3b5, vax provide truth/ machid(l) 

u3b5, vax provide truth value machid(l) 

uconfig system reconfiguration uconfig(lM) 

UID getpw(3e) 

ul do imderlining ul(l) 

ulimit get and set user limits ulimit(2) 

ulimit impose file size limit for sh(l) 

umask set and get file creation umask(2) 

umask set file-creation mode mask umask(l) 

mnask set permissions mask for csh(l) 

umask set permissions mask for sh(l) 

imiodem XMODEM-protocol file umodem(l) 

umount mount and dismount file mount[HFS](lM) 

umount mount and unmount file mount[non-HFS](lM) 

lunoimt immount a file system umount(2) 

imalias discard specified alias csh(l) 

imame get name of currentHP-UX uname(2) 

imame print name of current HP-UX uname(l) 

imcompact, ccat compress and compact(l) 

uncompress files, £ind cat them compact(l) 

imcompress, zcat compress and compress(l) 

imderlining ul(l) 

undial establish an out-going dial(3e) 

imdo a previous get of an SeeS unget(l) 

imexpand expand tabs to spaces, expand(l) 

imget undo a previous get of an unget(l) 

imgetc push character back into ungetc(3S) 

UNGETe, RETURN, ERROR, compile, regexp(5) 

unhash disable use of internal csh(l) 

imiformly distributed/ /jrand48, drand48(3e) 

imiq report repeated lines in a uniq(l) 

unique file name mktemp(3e) 

tmits conversion program units(l) 

UNIX system command execution uux(l) 

UNIX system copy uucp, uucp(l) 

UNIX system file copy uuto, uuto(l) 

(UNIX) system; terminal emulator cu(l) 

UNIX system to UNIX system uux(l) 

UNIX system to UNIX system copy uucp(l) 

UNIX system to UNIX system file uuto(l) 

imlink exercise link jind unlink link{lM) 

imlink remove directory entry; unlink(2) 

unlink system calls link(lM) 

unlock an interface ioJock(3I) 

unmount a file system umount(2) 

unmount file system mount[non-HFS](lM) 

unpack compress and expand files pack(l) 

unpack cpio archives from HP upm(l) 

unprintable characters in a file vis(l) 

unset remove definition/setting csh(l) 
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of flags and arguments 
environment 

value/ hpib wait_on ppoU wait 

pause suspend process 

condition/ hpib_status_wait wait 

and/or change times of/ touch 

programs make maintain, 

Isearch, Ifind linear search and 

update 

sync 

sync 

products 

media 

signal specify what to do 

trap execute command 

alloc show dynamic memory 

du summarize disk 

advise system about backing store 

calls to getmsg(3C) insertmsg 

unhash disable 

translate characters for 

classify characters for 

id print 

set real, effective, and saved 

setuid, setgid set 

times print accumulated 

crontab 

get character login name of the 

/geteuid, getgid, getegid get real 

environ 

generate disk accounting data by 

whoami print effective current 

line read one line from 

ulimit get and set 

logname return login name of 

notify notify 

/getegid get real user, effective 

su become super-user or another 

in the utmp file of the current 

write (talk) to another 

lastb indicate last logins of 

whodo which 

editor (variant of ex for casual 

profile set up 

by NLS /currlangid information on 

mail, rmail send mail to 

wall write to all 

bif bell interchange format 

ALLBASE/HP-UX HPIMAGE database 

HP-UX bootstrap and installation 

object file link information 

Command Set 80 Cartridge Tape 

modification times 



imset remove definition/setting sh(l) 

unsetenv remove variable from csh(l) 

untie terminfo de-compiler untic(lM) 

until a particular parallel poll hpib_wait_on ppoll(3I) 

until signal pause(2) 

imtil the requested status hpib__status_wait(3I) 

update access, modification, touch(l) 

update, and regenerate groups of make(l) 

update lse£irch(3C) 

update optional HP-UX products update(lM) 

update super-block sync(2) 

update the super block sync(lM) 

update update optional HP-UX update(lM) 

upm unpack cpio archives from HP upm(l) 

upon receipt of a signal signal(2) 

upon receipt of signal sh(l) 

usage csh(l) 

usage du(l) 

usage vsadv vsadv(2) 

use findstr(l) output to insert insertmsg(l) 

use of internal hash tables csh(l) 

use with NLS /nl tolower nl conv(3C) 

use with NLS /nl isgraph nl ctype(3C) 

user and group IDs and names id(l) 

user and group IDs /setresgid setresuid(2) 

user and group IDs setuid(2) 

user and system process times sh(l) 

user crontab file crontab(l) 

user cuserid cuserid(3S) 

user, effective user, real group,/ getuid(2) 

user environment environ(5) 

user ID diskusg diskusg(lM) 

user id whoami(l) 

user input line(l) 

user limits ulimit(2) 

user logname(3X) 

user of change in job status csh(l) 

user, real group, and effective/ getuid(2) 

user su(l) 

user ttyslot find the slot ttyslot(3C) 

user write interactively write(l) 

users and teletypes last, last(l) 

users are doing what whodo(lM) 

users) edit text edit(l) 

user's environment at login time profile(4) 

user's native language as given langinfo(3C) 

users or read mail mail(l) 

users wall(lM) 

ustat get file system statistics ustat(2) 

utilities bif(4) 

utilities hpiutil hpiutil(l) 

utility hpux hpuxboot(lM) 

utility linkinfo linkinfo(l) 

Utility tcio tcio(l) 

utime set file access and utime(2) 
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endutent, utmpname access 

ttyslot find the slot in the 

utmp, wtmp, btmp 

entry format 

/pututline, setutent, endutent, 

clean-up 

uuxqt 

uucico 

uusub monitor 

unclean 

control uustat 

uusnap show snapshot of the 

transaction uuls list spooled 

to UNIX system copy 

system copy uucp, 

transactions grouped by/ 

copy uucp, uulog, 

system file copy uuto, 

system 

job control 

to UNIX system file copy 
command execution 



val 

/u3b, u3b5, vax provide truth 

abs return integer absolute 

getenv return 

ceiling, remainder, absolute 

until a particular parallel poll 

getitimer, setitimer get/set 

return exit fimction with return 

putenv change or add 

privgrp format of privileged 

true, false provide truth 

values machine-dependent 

print formatted output of a 

list 

varargs handle 

setenv define environment 

unsetenv remove 

langid language identification 

subsequent/ export export 

edit text editor 

/hp9000s800, pdpU, u3b, u3b5, 

get option letter from argument 

assert 

expand tabs to spaces, and vice 

stty terminal interface for 

to different operating system or 



utmp file entry /setutent, getut(3C) 

utmp file of the current user ttyslot(3C) 

utmp, wtmp, btmp entry format utmp(4) 

utmp, wtmp, btmp utmp, wtmp, btmp .. utmp(4) 

utmpname access utmp file entry getut(3C) 

uucico uucp copy in and copy out uucico(lM) 

unclean uucp spool directory uuclean(lM) 

uucp command execution uuxqt(lM) 

uucp copy in and copy out uucico(lM) 

uucp network uusub(lM) 

uucp spool directory clean-up uuclean(lM) 

uucp status inquiry and job uustat(l) 

UUCP system uusnap(lM) 

uucp transactions grouped by uuls(lM) 

uucp, uulog, uuname UNIX system uucp(l) 

uulog, uuname UNIX system to UNIX ... uucp(l) 

uuls list spooled uucp uuls(lM) 

uuname UNIX system to UNIX system .. uucp(l) 

unpick public UNIX system to UNIX uuto(l) 

uusnap show snapshot of the UUCP uusnap(lM) 

uustat uucp status inquiry and uustat(l) 

uusub monitor uucp network uusub(lM) 

uuto, uupick public UNIX system uuto(l) 

uux UNIX system to UNIX system uux(l) 

uuxqt uucp command execution uuxqt(lM) 

val validate SCCS file val(l) 

validate SCCS file val(l) 

value about your processor type machid(l) 

value abs(3C) 

value for environment name getenv (3C) 

value functions /fabs floor, floor(3M) 

value occurs /wait hpib_wait on ppoll(3I) 

value of interval timer getitimer(2) 

value sh(l) 

value to environment putenv(3C) 

values machine-dependent values values(5) 

values privgrp(4) 

values true(l) 

values values(5) 

varargs argument list /vsprintf vprintf(3S) 

varargs handle variable argument varargs(5) 

variable argument list varargs(5) 

variable csh(l) 

variable from environment csh(l) 

variable langid(5) 

variable names to environment of sh(l) 

(variant of ex for casual users) edit(l) 

vax provide truth value about/ machid(l) 

vc version control vc(l) 

vector /optarg, optind, opterr getopt(3C) 

verify program assertion assert(3X) 

versa expand, unexpand expand(l) 

Version 6/PWB compatibifity sttyv6(7) 

version chsys change chsys(lM) 

version control vc(l) 
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get get a 

uname print name of current HP-UX 

sccsdifF compare two 

virtual memory efficient way 

formatted output of a/ vprintf, 

display editor based on ex 

expand tabs to spaces, and 

page file perusal filter for crt 

fix manual pages for faster 

clrsvc clear x25 switched 

vfork spawn new process La a 

statistics vstat collect 

vmstat report 

characters in a file visible or/ 

unprintable characters in a file 

ex vi screen-oriented 

statistics 

rootmark mark/unmark 

osmark mark SDF 

fs format of file system 

fs format of system 

lifinit write LIF 

mark/immark volume as HP-UX root 

or move files to/from an SDF 

Structured Directory Format 

formatted output of a varsirgs/ 

store usage 

store devices vson, 

backing store devices 

of a varargs/ vprintf, vfprintf, 

performance statistics 

Ian 

vtdaemon respond to 



wait 

terminate wait 

release blocked signals and 

termination status wait 

poll value/ hpib_wait_on ^ppoll 

condition/ hpib status_wait 

processes 

stop or terminate 

termination status 

ftw 

count 

and/or manual for program 

user id 

io_width ctl set 

fold fold long lines for finite 

prof profile 

glob echo 

exec execute command 



version of an SCCS file get(l) 

version imame(l) 

versions of an SCGS file 3ccsdiff(l) 

vfork spawn new process in a vfork(2) 

vfprintf, vsprintf print vprintf(3S) 

vi screen-oriented (visual) vi(l) 

vice versa expand, unexpand expand(l) 

viewing more, more(l) 

viewing with man(l) fixman fixman(l) 

virtual circuit clrsvc(lM) 

virtual nlemory efficient way vfork(2) 

virtual memory performance vstat(lM) 

virtual memory statistics vmstat(l) 

vis, inv make unprintable vis(l) 

visible or invisible /inv make vis(l) 

(visual) display editor based on vi(l) 

vmstat report virtual memory vmstat (1) 

volume as HP-UX root volmne rootm£irk(lM) 

voltune boot area as/ osmark(lM) 

volume fs[HFS](4) 

volume fs[SDF](4) 

volmne header on file lifinit(l) 

volume rootmark rootmark(lM) 

volume /sdfln, sdfmv copy, link, sdfcp(l) 

volume sdfinit initialize sdfinit[SDF](lM) 

vprintf, vfprintf, vsprintf print vprintf (38) 

vsadv advise system about backing vsadv(2) 

vsoff advise OS about backing vson(2) 

vson, vsoff advise OS about vson(2) 

vsprintf print formatted output vprintf (3S) 

vstat collect virtual memory vstat(lM) 

vt login to another system over vt(l) 

vt requests vtdaemon(lM) 

vtdaemon respond to vt requests vtdaemon(lM) 

wait await completion of process wait(l) 

wait for backgroimd processes csh(l) 

wait for child process to stop or wait(2) 

wait for interrupt /atomically sigpause(2) 

wait for process and report sh(l) 

wait until a particular parallel hpib_wait_on ppoll(3I) 

wait until the requested status hpib status_wait(3I) 

wait wait for background csh(l) 

wait wait for child process to wait(2) 

wait wait for process and report sh(l) 

walk a file tree ftw(3C) 

wall write to all users wall(lM) 

wc word, line, and character wc(l) 

whereis locate source, binary, whereis(l) 

whoami print effective cm-rent whoami(l) 

whodo which users are doing what whodo(lM) 

width of data path io_width ctl(3I) 

width output device fold(l) 

within a function prof(5) 

without '\' escapes csh(l) 

without creating new process csh(l) 
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exec execute command 

fgetc, getw get character or 

wc 

fputc, putw put character or 

hyphen find hyphenated 

cd change 

chdir change ' 

cd change 

chdir change cmrent 

getcwd get path-name of current 

pwd 

pwd 

cd change 

to another user 

lifinit 

write, writev 

putpwent 

write interactively 

wall 

write, 

open open file for reading or 

utmp, wtmp, btmp utmp, 

format utmp, 

accoimting records fwtmp, 

getx25 get 

clrsvc clear 

£ind execute command 

od, 

program imiodem 

JO, jl, jn, 

J0,jl,jn,y0, 

compiler-compiler 

yacc 

jO, jl, jn, yO, yl, 

compress, imcompress, 

and ctime(3C) tztab time 



without creating new process sh(l) 

word from a stream file /getchar, getc(3S) 

word, line, and character count wc(l) 

word on a stream putc, putchar, putc(3S) 

words hyphen(l) 

working directory cd(l) 

working directory chdir(2) 

working directory C8h(l) 

working directory C8h(l) 

working directory getcwd(3C) 

working directory name pwd(l) 

working directory name sh(l) 

working directory 8h(l) 

write interactively write (talk) write(l) 

write LIF volume header on file lifinit(l) 

write on a file write(2) 

\^rite password file entry putpwent(3C) 

write (talk) to another user write(l) 

write to all users wall(lM) 

write, writev write on a file write(2) 

writev write on a file write(2) 

writing open(2) 

wtmp, btmp entry format utmp(4) 

wtmp, btmp utmp, wtmp, btmp entry ... utmp(4) 

wtmpfix manipulate connect fwtmp(lM) 

x25 line getx25(lM) 

x25 switched virtual circuit clrsvc(lM) 

xargs construct argimaent list(s) xargs(l) 

xd octal and hexadecimal dump od(l) 

XMODEM-protocol file transfer imiodem(l) 

yO, yl, yn Bessel functions bessel(3M) 

yl, yn Bessel functions bessel(3M) 

yacc yet another yacc(l) 

yet another compiler-compiler yacc(l) 

yn Bessel functions bessel(3M) 

zcat compress and expand data compress(l) 

zone adjustment table for date(l) tztab(4) 
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